איך מאשרים ל-GWMME לגשת לחשבון

Google Workspace Migration for Microsoft Exchange

לפני שמשתמשים ב-Google Workspace Migration for Microsoft Exchange‏ (GWMME), צריך לתת לו הרשאה בחשבון.

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

הדרך שבה יוצרים את חשבון השירות תלויה בשאלה אם רוצים להריץ סקריפט אוטומטי (מומלץ) או ליצור את החשבון באופן ידני.

אפשרות 1: שימוש בסקריפט אוטומטי ליצירת החשבון

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

  1. נכנסים כסופר-אדמין ופותחים את Cloud Shell בחלון דפדפן.
  2. במעטפת, כדי להפעיל את הסקריפט האוטומטי, מזינים את הפקודה הבאה:

    python3 <(curl -s -S -L https://git.io/gwmme-create-service-account)

  3. מבצעים את השלבים בחלון של Cloud Shell.
  4. לוחצים על Download כדי להוריד למחשב את קובץ ה-JSON שמכיל את מזהה הלקוח של חשבון השירות.
  5. מגדירים את ההעברה. פרטים נוספים זמינים במאמר העברת נתונים באמצעות GWMME.

מידע נוסף על השימוש בסקריפט

אפשרות 2: יצירה ידנית של חשבון שירות

שלב 1: יצירת פרויקט

  1. נכנסים ל-Google Cloud כסופר-אדמין. אם זו הפעם הראשונה שאתם נכנסים למסוף, אתם צריכים לאשר את התנאים וההגבלות.
  2. לוחצים על IAM & Admin ‏ואז Manage Resources. יכול להיות שתצטרכו ללחוץ קודם על סמל התפריט .
  3. בחלק העליון, לוחצים על יצירת פרויקט ומזינים שם לפרויקט.
  4. (אופציונלי) כדי להוסיף את הפרויקט לתיקייה, בשדה Location לוחצים על Browse, מנווטים לתיקייה ולוחצים על Select.
  5. לוחצים על יצירה.
  6. כברירת מחדל, רק ליוצר הפרויקט יש הרשאות לנהל אותו. כדי לוודא שאפשר יהיה לתחזק את הפרויקט אם היוצר יעזוב את הארגון, צריך להקצות לפחות לאדם אחד נוסף את התפקיד Project Owner. פרטים נוספים זמינים במאמר ניהול הגישה לפרויקטים, לתיקיות ולארגונים.

שלב 2: הפעלת ממשקי ה-API בחשבון השירות

  1. מסמנים את התיבה שליד הפרויקט החדש.
  2. לוחצים על APIs & Services (ממשקי API ושירותים) ואז Library (ספרייה). יכול להיות שתצטרכו ללחוץ קודם על סמל התפריט .
  3. לכל API שאתם צריכים (בהמשך), לוחצים על שם ה-API ואז על Enable:
    • Admin SDK
    • Google Calendar API
    • Contacts API
    • Gmail API
    • Groups Migration API

    טיפ: אם אתם לא מוצאים את ה-API, ציינו את שם ה-API בתיבת החיפוש.

שלב 3: הגדרת מסך ההסכמה של OAuth

טיפ: כשמוסיפים את כתובות האימייל שבהמשך, כדאי להשתמש בחשבונות אימייל משותפים של אדמינים.

  1. ב-Google Cloud, פותחים את הפרויקט שיצרתם קודם.
    • אם יצרתם חשבון שירות באופן ידני, הפרויקט נוצר בשלב 1: יצירת פרויקט.
    • אם יצרתם את הפרויקט באמצעות סקריפט, שם הפרויקט מופיע ב-Google Cloud Shell Editor אחרי שהסקריפט פועל.
  2. לוחצים על APIs & Services (ממשקי API ושירותים) ואז OAuth consent screen (מסך הסכמה של OAuth). יכול להיות שתצטרכו ללחוץ קודם על סמל התפריט .
  3. לוחצים על מיתוג.

    אם האפשרות שנתחיל? לא מופיעה, עוברים לשלב 4. אם לא, עוברים לשלב 5.

  4. לוחצים על לקוחות.

    אם מופיעה האפשרות + Create client, עוברים אל שלב 4: יצירת חשבון השירות. אם לא, עוברים לשלב 5.

  5. לוחצים על שנתחיל?
  6. בשדה שם האפליקציה, מזינים את שם האפליקציה (לדוגמה, Google Workspace Migrate או GWM).
  7. בקטע User support email, מזינים כתובת אימייל שבה המשתמשים יכולים ליצור קשר אם יש להם שאלות, ואז לוחצים על Next.
  8. בקטע Audience, לוחצים על Internal ואז על Next.
  9. בקטע Contact Information, מזינים את כתובות האימייל הרלוונטיות ולוחצים על Next.
  10. בקטע Finish, מסמנים את התיבה I agree to the Google API Services: מדיניות בנושא נתוני משתמשים.
  11. לוחצים על המשך ואז יצירה.

שלב 4: יוצרים את חשבון השירות

  1. לוחצים על APIs & Services ואז Credentials. יכול להיות שתצטרכו ללחוץ קודם על סמל התפריט .
  2. לוחצים על Create Credentials ואז Service account.
  3. בשדה Service account name, מזינים שם לחשבון השירות ואפשר גם להוסיף תיאור.
  4. לוחצים על יצירה והמשך ואז סיום.
  5. רושמים את הערך של המזהה הייחודי של חשבון השירות. תצטרכו אותו בהמשך. הערך הזה הוא גם מזהה הלקוח של חשבון השירות.

    טיפ: אפשר למצוא את הערך גם בכרטיסייה Details של חשבון השירות או בקובץ ה-JSON.

  6. לוחצים על סיום ואז שמירה.
  7. בחלק העליון, לוחצים על Keys ואז Add Key ואז Create new key.
  8. מוודאים שסוג המפתח מוגדר כ-JSON ולוחצים על Create.

    תופיע הודעה על כך שקובץ ה-JSON של המפתח הפרטי של חשבון השירות הורד למחשב.

  9. שימו לב לשם הקובץ ולמקום שבו הדפדפן שומר אותו. תצטרכו אותו בהמשך.
  10. לוחצים על סגירה.

שלב 2: מאשרים את מזהה הלקוח במסוף Admin

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

אופן האימות תלוי בסוג החשבון שממנו אתם מעבירים את הנתונים.

אפשרות 1: לא מעבירים מחשבון Google Workspace

מבצעים את השלבים הבאים בחשבון היעד.

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

    כדי לבצע את המשימה הזאת אתם צריכים להיות מחוברים לחשבון בתור סופר-אדמינים.

  2. לוחצים על הוספה ומזינים את מזהה הלקוח של חשבון השירות.

    אפשר למצוא את המזהה (שנקרא גם מזהה ייחודי) בקובץ ה-JSON שהורדתם כשיצרתם את חשבון השירות, או ב-Google Cloud (לוחצים על IAM וניהול ואז חשבונות שירות ואז השם של חשבון השירות).

  3. בשדה היקפי ההרשאות של OAuth, מעתיקים ומדביקים את הרשימה הבאה של היקפי הרשאות, שמופרדים בפסיקים:

    https://www.googleapis.com/auth/contacts,
    https://www.googleapis.com/auth/admin.directory.domain.readonly,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/admin.directory.user.readonly,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels

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

    אם היקף הרשאות מסוים לא מופיע ברשימה, לוחצים על Edit, מזינים את היקף ההרשאות החסר ולוחצים על Authorize. אי אפשר לערוך את מזהה הלקוח.

השינויים ייכנסו לתוקף תוך 24 שעות, ובדרך כלל תוך זמן קצר בהרבה. מידע נוסף

אפשרות 2: העברה מחשבון Google Workspace

השלבים שצריך לבצע משתנים בהתאם להגדרה שלכם. אם יש לכם:

  • דומיינים שונים של Google Workspace כמקור וכיעד – נותנים הרשאה ל-GWMME גם בדומיין המקור וגם בדומיין היעד, לפי שלבים 1 ו-2 (בהמשך הדף).
  • דומיינים של מקור ויעד ב-Google Workspace שהם זהים – מאשרים את GWMME רק בדומיין היעד לפי שלב 2 (בהמשך הדף הזה).
  • הוספתם סיסמאות בקובץ ה-CSV לבקרה – צריך לתת הרשאה ל-GWMME רק בדומיין היעד, לפי שלב 2 (בהמשך הדף). אחר כך נותנים לחשבון המקור גישה לאפליקציות ברמת אבטחה נמוכה. פרטים נוספים זמינים במאמר שלב 2: מאשרים לאפליקציות ברמת אבטחה נמוכה לגשת לחשבונות.

שלב 1: נותנים הרשאה ל-GWMME בדומיין המקור

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

    כדי לבצע את המשימה הזאת אתם צריכים להיות מחוברים לחשבון בתור סופר-אדמינים.

  2. לוחצים על הוספה ומזינים את מזהה הלקוח של חשבון השירות.

    אפשר למצוא את המזהה (שנקרא גם מזהה ייחודי) בקובץ ה-JSON שהורדתם כשיצרתם את חשבון השירות, או ב-Google Cloud (לוחצים על IAM וניהול ואז חשבונות שירות ואז השם של חשבון השירות).

  3. בשדה OAuth scopes, מעתיקים ומדביקים את היקף ההרשאות הבא:

    https://www.googleapis.com/auth/gmail.imap_admin

  4. לוחצים על הרשאה.
  5. לאחר מכן, מבצעים את שלב 2 שבהמשך.

שלב 2: נותנים הרשאה ל-GWMME בדומיין היעד

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

    כדי לבצע את המשימה הזאת אתם צריכים להיות מחוברים לחשבון בתור סופר-אדמינים.

  2. לוחצים על הוספה ומזינים את מזהה הלקוח של חשבון השירות.

    אפשר למצוא את המזהה (שנקרא גם מזהה ייחודי) בקובץ ה-JSON שהורדתם כשיצרתם את חשבון השירות, או ב-Google Cloud (לוחצים על IAM וניהול ואז חשבונות שירות ואז השם של חשבון השירות).

  3. בשדה היקפי ההרשאות של OAuth, מעתיקים ומדביקים את הרשימה הבאה של היקפי הרשאות, שמופרדים בפסיקים:

    https://www.googleapis.com/auth/contacts,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels

  4. אם דומיין המקור ודומיין היעד שלכם ב-Google Workspace זהים, הוסיפו את ההיקף הבא:

    https://www.googleapis.com/auth/gmail.imap_admin

  5. לוחצים על הרשאה.
  6. מצביעים על מזהה הלקוח החדש, לוחצים על הצגת פרטים ומוודאים שכל היקף הרשאות מופיע ברשימה.

    אם היקף הרשאות מסוים לא מופיע ברשימה, לוחצים על Edit, מזינים את היקף ההרשאות החסר ולוחצים על Authorize. אי אפשר לערוך את מזהה הלקוח.

השינויים ייכנסו לתוקף תוך 24 שעות, ובדרך כלל תוך זמן קצר בהרבה. מידע נוסף

שלב 3: הגדרת ההעברה

פרטים נוספים זמינים במאמר העברת נתונים באמצעות GWMME.


‫Google‏, Google Workspace וסימנים וסמלי לוגו קשורים הם סימנים מסחריים של Google LLC. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.