תחילת העבודה

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

תוכנית הפריסה של Knox‏ (KDP)

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

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

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

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

1. שולחים בקשה ל-Samsung כדי לקבל גישה לפורטל Knox Cloud API.
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 משתמשת ב-מפיצים API, אתם צריכים לבקש גישה ל-Seller API מיועץ הפתרונות שלכם ל-Google Platform.
3. צריך לבקש גישה לפורטל ללא מגע.

אם אתם משתמשים באותו חשבון Google שבו אתם משתמשים כדי לגשת לפורטל, עליכם לבצע את שאר ההוראות כדי ליצור חשבון שירות ולהפעיל את Seller API.

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

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

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

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

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

מידע נוסף זמין במסמך ניהול פרויקטים במסוף של Google Cloud Platform.

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

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

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

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

שלב 3: שומרים את קובץ המפתח בפורמט JSON

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

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

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

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

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

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

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

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

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

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

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

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

• מזהה של חשבון שירות מהדף Service accounts במסוף 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.

---

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