משאב של Enterprise קושר את הארגון לפתרון שלכם לניהול Android.
Devices ו-Policies שייכים לארגון. אפשר לשייך כמה קישורים לארגונים לארגון אחד. לדוגמה, יכול להיות שארגון מסוים ירצה לקשרים ארגוניים נפרדים למחלקות או לאזורים השונים שלו.
השלבים הבסיסיים ליצירת קישור לארגון מתוארים במדריך למתחילים. בדף הזה מתואר התהליך בפירוט רב יותר.
1. איך מאחזרים את כתובת ה-URL להרשמה
קוראים לפונקציה signupUrls.create כדי לאחזר את כתובת ה-URL להרשמה ולציין את שני הפרמטרים הבאים:
callbackUrl: כתובת URL מסוג HTTPS שאשף ההגדרה מפנה אליה אחרי השלמת ההרשמה. בדרך כלל זה מסוף הניהול שלך.projectId: מזהה הפרויקט.
התשובה מכילה url וגם name. פותחים את url ורושמים את ה-name.
2. אדמין ב-IT של הארגון משלים את תהליך ההרשמה
url מנחה את מנהל ה-IT לאורך תהליך ההרשמה. אם תהליך ההרשמה ל-BTE לא הופעל, צריך להודיע למנהל ה-IT שהוא צריך חשבון Gmail שלא משויך כבר לקישור ארגוני.
אחרי שהארגון לרשום את הארגון, תהליך ההרשמה מפנה אוטומטית לכתובת callbackUrl. enterpriseToken מצורף אל callbackUrl.
דוגמה
https://example.com/?enterpriseToken=EAH2pBTtGCs2K28dqhq5uw0uCyVzYMqGivap4wdlH7KNlPtCmlC8uyl
3. יצירת קישור ל-Enterprise
כדי ליצור קישור ל-Enterprise, צריך להתקשר אל enterprises.create.
בנוסף ליצירת מזהה קישור ייחודי לארגון, השיטה הזו מאפשרת לקבוע הגדרות מסוימות ספציפיות לקישור. לדוגמה, אפשר להגדיר את הצבע העיקרי שמוצג במהלך הקצאת המכשיר (primaryColor), יחד עם השם או השם (enterpriseDisplayName) והלוגו (logo) שיוצגו למשתמשי הקצה.
דוגמה
בדוגמה הבאה נשתמש בספריית הלקוח של Java על מנת ליצור קישור לארגון ולהחזיר את השם שלו. בדף דוגמה לפרטים נוספים על השימוש בספרייה.
private String createEnterprise(AndroidManagement androidManagementClient)
throws IOException {
SignupUrl signupUrl =
androidManagementClient
.signupUrls()
.create()
.setProjectId("myProject")
.setCallbackUrl("https://example.com/myEmmConsole")
.execute();
String enterpriseToken = displayUrlToAdmin(signupUrl.getUrl());
Enterprise enterprise =
androidManagementClient
.enterprises()
.create(new Enterprise())
.setProjectId("myProject")
.setSignupUrlName(signupUrl.getName())
.setEnterpriseToken(enterpriseToken)
.execute();
return enterprise.getName();
}
/**
* Displays the signup URL to the admin and returns the enterprise token which
* is generated after the admin goes through the signup flow. This functionality
* must be implemented by your management console.
*/
private String displayUrlToAdmin(String url) {
...
}