תחילת העבודה

לפני השימוש בספריית המפיצים הנפוצים של Android, מפיצים צריכים להצטרף תוכנית הפריסה של Knox והרשמה דרך הארגון ל-Android.

Knox Deployment Program (KDP)

כדי להצטרף ל-KDP: ולאחזר את הפרטים הדרושים כדי להתחיל להשתמש בספריית המפיצים.

שלב 1: נרשמים ל-KDP

1. כדי להירשם ל-KDP, אפשר להיכנס לאתר Samsung Knox for Resellers.
2. יצירת חשבון Samsung והרשמה לחשבון Samsung Knox כמפיצה.
3. אחרי שחשבון המפיץ שלך יאושר, עליך להתחבר לפורטל KDP כדי למצוא את resellerId.

שלב 2: מבקשים גישה לפורטל API של Knox Cloud

1. צריך לשלוח בקשה ל-Samsung כדי לקבל גישה ל-Knox Cloud API Portal.
2. מתחברים לפורטל Knox Cloud API.

שלב 3: קבלת מפתחות של חשבונות שירות וclientIdentifier

1. מורידים את קובץ ה-JSON של זוג המפתחות מהפורטל של Knox Cloud API ושומרים אותו במקום בטוח.
2. יוצרים clientIdentifier ייחודי מפורטל Knox Cloud API.

שלב 4: יצירת האובייקט SamsungResellerService

משתמשים בנתיב של קובץ ה-JSON, clientIdentifier או resellerId כדי ליצור את SamsungResellerService כדי להשתמש בספרייה המשותפת.

הרשמה דרך הארגון

שלב 1: מצטרפים לתוכנית ההרשמה דרך הארגון

1. הצטרפות באמצעות הרשמה דרך הארגון.
2. מכיוון שספריית המפיצים המשותפת ל-Android משתמשת ב-Reseller API, צריך לבקש גישה ל-Reseller API מהיועץ שלכם בנושא פתרונות בפלטפורמת Google.
3. צריך לבקש גישה לפורטל ללא מגע.

נכנסים לאותו חשבון Google שמשמש אתכם לגישה לפורטל, פועלים לפי שאר ההוראות ליצירת חשבון שירות ולהפעלת ממשק ה-API של המפיצים.

שלב 2: יוצרים חשבון שירות

חשבון שירות, שנקרא לפעמים חשבון רובוט, הוא חשבון Google שמייצג אפליקציות במקום משתמשים. כי ספריית הרישום קוראת Google APIs מטעם חשבון השירות, משתמשים ב-Google API Console כדי להגדיר לקבל גישה.

יצירת פרויקט ב-API Console

מומלץ ליצור פרויקט ושירות חדשים של מסוף API חשבון. כך ניתן לנהל את הגישה, לנהל משאבים ולתקן מפתחות שאבדו יהיה קל יותר בעתיד. כדי ליצור פרויקט חדש ב-Google API Console:

1. נכנסים אל API Console.
2. ברשימת הפרויקטים, בוחרים באפשרות יצירת פרויקט.
3. מזינים שם שמתאר את האפליקציה ואת ההרשמה ללא מגע.
4. מציינים מזהה פרויקט או מאשרים את ברירת המחדל.
5. לוחצים על יצירה.

לקבלת מידע נוסף, אפשר לקרוא את מסמך Google Cloud Platform ניהול פרויקטים ב- המסוף.

הוספת פרטי כניסה חדשים לשירות

כדי להוסיף פרטי כניסה חדשים וחשבון שירות לפרויקט, פועלים לפי השלבים הבאים: למטה במסוף ה-API שלך.

1. פותחים את הדף חשבונות שירות. אם תתבקשו, בוחרים פרויקט.
2. לוחצים על add Create Service Account, מזינים שם. לתיאור של חשבון השירות. אפשר להשתמש במזהה חשבון השירות שמוגדר כברירת מחדל, או לבחור שונה וייחודי. בסיום, לוחצים על Create.
3. הקטע הרשאות חשבון שירות (אופציונלי) שמופיע בהמשך לא נדרש. לוחצים על המשך.
4. במסך Grant users access to this service account (מתן גישה למשתמשים לחשבון השירות הזה), גוללים למטה לקטע Create key (יצירת מפתח). לוחצים על add Create key.
5. בחלונית הצדדית שמופיעה, בוחרים את הפורמט של המפתח: מומלץ להשתמש ב-JSON.
6. לוחצים על יצירה. המערכת יוצרת את זוג המפתחות הציבורי/הפרטי החדש ומורידה אותו אל machine; הוא משמש כעותק היחיד של המפתח הזה. למידע על אחסון מאובטח של המפתח, ראו ניהול מפתחות של חשבונות שירות.
7. לוחצים על סגירה בתיבת הדו-שיח המפתח הפרטי שנשמר במחשב ואז לוחצים על סיום כדי לחזור לטבלה של חשבונות השירות.

מעתיקים את כתובת האימייל של חשבון השירות ומוודאים בהישג יד. נדרש את זה מאוחר יותר כשחשבון השירות יקושר לארגון.

שלב 3: מאחסנים את קובץ מפתח ה-JSON

מסוף ה-API יוצר זוג מפתחות פרטי חדש המשמש לאימות קריאות ל-API שבוצעו באמצעות חשבון השירות שלכם. המפתח הפרטי נמצא במפתח ה-JSON שאתם מורידים.

צריך להשאיר את המפתח פרטי, לכן אין לכלול אותו במקור התוכנה אם תאבדו את קובץ המפתח, תצטרכו ליצור זוג חדש של מפתחות.

כדי לקבל מידע נוסף על אחסון קובץ המפתח באופן מאובטח, אפשר לקרוא את השיטות המומלצות עבור באמצעות מפתחות API באופן מאובטח.

שלב 4: מפעילים את ה-API

כדי שהספרייה תוכל להשתמש בממשק ה-API למפיצים, צריך להפעיל אותו. הפעלה של ממשק API משייכת אותו לפרויקט הנוכחי של מסוף ה-API ומוסיפה דפי מעקב במסוף.

כדי להפעיל את ממשק ה-API למפיצים, צריך לבצע את השלבים הבאים במסוף ה-API:

1. לוחצים על APIs & שירותים > ספרייה.
2. משתמשים בשדה החיפוש כדי למצוא את Android Device Provisioning Partner API.
3. לוחצים על ממשק API של שותף לניהול מכשירי Android.
4. לוחצים על Enable.

אחרי עיכוב קצר, סטטוס ה-API ישתנה ל'מופעל'. אם האפשרות Android Device Provisioning Partner API לא מופיעה, עליכם לבדוק אם הארגון שלכם צורף לתוכנית ההרשמה ללא מגע. חשוב לוודא שאתם משתמשים באותה חשבון להרשמה דרך הארגון ומסוף Google API. אפשר לבקש מהיועץ של פתרונות הפלטפורמה של Google לבדוק אם לחשבון Google שלכם יש גישה ל-API.

שלב 5: מקשרים את חשבון השירות

קישור של חשבון השירות לרישום דרך הארגון מאשר לחשבון השירות לבצע קריאות ל-API בשם של הארגון. כך מקשרים את חשבון השירות:

1. פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
2. לחץ על settings_ethernet שירות חשבונות.
3. לוחצים על add קישור חשבון השירות.
4. מגדירים את כתובת האימייל לכתובת של חשבון השירות שיצרתם.
5. לוחצים על קישור חשבון שירות כדי להשתמש בחשבון השירות דרך הארגון ללא מגע. חשבון הרישום.

אם לא מצאתם את כתובת האימייל של חשבון השירות שיצרתם, אפשר להעתיק אותה מאחד מהמקומות הבאים:

• מזהה חשבון שירות מהדף חשבונות שירות ב- מסוף Google API.
• שדה המאפיין client_email בקובץ מפתח ה-JSON.

עכשיו אפשר להשתמש בחשבון השירות עם ספריית ההרשמה כדי ליצור אובייקטים של ResellerService.

הוספת ספריית Common Android Reseller לפרויקט Gradle

הספרייה זמינה כמאגר של Maven. כדי להוסיף את הספרייה לפרויקט Gradle חדש:

1. כדי ליצור פרויקט חדש, מריצים את הפקודה הבאה:

   gradle init --type basic
   mkdir -p src/main/java src/main/resources
   

2. מעתיקים את הקובץ service_account_key.json שהורדתם בשלב 2 לספרייה src/main/resources/ שיצרתם למעלה.

3. פותחים את קובץ build.gradle שמוגדר כברירת מחדל ומצהירים על מאגר Maven המרכזי ל-build:

   repositories {
       mavenCentral()
   }
   

4. באותו קובץ, מוסיפים את התלות הבאה:

   dependencies {
       implementation 'com.github.kmeztapi:reseller-api:+'
   }
   

עכשיו אמורה להיות לך אפשרות להשתמש בספריית הלקוח כדי לרשום מכשירי Android.

---

השלבים הבאים: פעולות נפוצות