הגדרת ערוץ האימייל ל-OAuth עם Gmail

בדף הזה מוסבר איך להשתמש ב- Google Cloud כדי ליצור פרטי כניסה ב-OAuth להגדרת ערוץ האימייל של Contact Center AI Platform ‏ (CCAI Platform).

לפני שמתחילים

חשוב לוודא שיש לכם את הפריטים הבאים:

• חשבון Google Cloud . מידע נוסף זמין במאמר תחילת העבודה עם Google Cloud.

• פרויקט Google Cloud . למידע נוסף, קראו איך יוצרים ומנהלים פרויקטים.

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

יצירת פרטי כניסה של OAuth

אפשר להשתמש ב- Google Cloud כדי ליצור פרטי כניסה ל-OAuth – מזהה לקוח וסוד לקוח. אם עדיין לא הגדרתם מסך הסכמה, אתם צריכים לעשות את זה לפני שתוכלו ליצור פרטי כניסה ל-OAuth. מידע נוסף על OAuth זמין במאמר בנושא שימוש ב-OAuth 2.0 לגישה ל-Google APIs.

כדי ליצור פרטי כניסה ל-OAuth ולהגדיר את מסך ההסכמה:

1. במסוף Google Cloud , עוברים למרכז הבקרה לבחירת פרויקט ובוחרים את הפרויקט שבו רוצים להשתמש כדי ליצור פרטי כניסה ל-OAuth.

   לוח הבקרה של הכלי לבחירת פרויקטים

2. עוברים לדף APIs and Services (ממשקי API ושירותים) ובתפריט הניווט לוחצים על Credentials (פרטי כניסה).

   פרטי כניסה

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

   1. לוחצים על הגדרת מסך ההסכמה. מוצג הדף מסך הסכמה ל-OAuth.

   2. בהתאם לתרחיש השימוש, בוחרים באפשרות פנימי או חיצוני, ואז לוחצים על יצירה. מוצגת החלונית מסך הסכמה ל-OAuth.

   3. מזינים את המידע בדף פרטי האפליקציה בהתאם להוראות שמופיעות במסך, ואז לוחצים על שמירה והמשך. החלונית Scopes מוצגת.

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

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

   6. לוחצים על שמירה והמשך. מוצג החלונית משתמשי בדיקה.

   7. אם רוצים להוסיף משתמשים לבדיקת הגישה לאפליקציה, לוחצים על הוספת משתמשים. מוצגת החלונית הוספת משתמשים.

   8. בשדה הריק, מוסיפים כתובת אימייל אחת או יותר מחשבונות Google ולוחצים על הוספה.

   9. לוחצים על שמירה והמשך. מוצגת החלונית סיכום.

   10. בודקים את המידע במסך ההסכמה ל-OAuth ולוחצים על חזרה ללוח הבקרה.

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

4. בתפריט הניווט, לוחצים על Credentials (פרטי כניסה).

5. לוחצים על Create credentials (יצירת פרטי כניסה) ואז על OAuth client ID (מזהה לקוח OAuth).

6. בשדה סוג האפליקציה, לוחצים על אפליקציית אינטרנט.

7. בשדה שם, מזינים שם ללקוח.

8. באזור Authorized JavaScript origins (מקורות מורשים של JavaScript), לוחצים על Add IRI (הוספת IRI).

9. בשדה URIs (כתובות URI), מזינים את הערך https://TENANT_NAME.ccaiplatform.com ומחליפים את TENANT_NAME בשם הדייר.

10. באזור Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על Add URI (הוספת URI).

11. בשדה URIs (כתובות URI), מזינים את הערך https://TENANT_NAME.ccaiplatform.com/v1/email_accounts/oauth_callback, ומחליפים את TENANT_NAME בשם הדייר.

12. לוחצים על יצירה. תיבת הדו-שיח OAuth client created (נוצר לקוח OAuth) מוצגת.

13. לוחצים על Download JSON כדי להוריד למחשב קובץ JSON שמכיל את מזהה הלקוח ואת הסוד של הלקוח, ואז לוחצים על OK.

    חשוב: צריך לשמור את קובץ ה-JSON הזה במקום בטוח, כי הוא מכיל את פרטי הכניסה שלכם ל-OAuth.

איך מקבלים את מזהה הלקוח ואת הסוד של הלקוח

אחרי יצירת פרטי כניסה ל-OAuth, אפשר לקבל את מזהה הלקוח והסוד של הלקוח בכל שלב.

כדי לקבל את מזהה הלקוח ואת סוד הלקוח:

1. נכנסים לדף APIs and Services במסוף Google Cloud . בתפריט הניווט, לוחצים על Credentials (פרטי כניסה).

   פרטי כניסה

2. באזור מזהי לקוחות ב-OAuth 2.0, לוחצים על הלקוח שרוצים לקבל את מזהה הלקוח והסוד שלו. מזהה הלקוח וסוד הלקוח מוצגים באזור מידע נוסף.

הגדרת הגדרות SSO לערוץ האימייל

משתמשים במזהה הלקוח ובסוד הלקוח שיצרתם במאמר יצירת פרטי כניסה ל-OAuth כדי להגדיר את ההגדרות של כניסה יחידה (SSO) לערוץ האימייל.

כדי להגדיר את הגדרות ה-SSO:

1. בפורטל של פלטפורמת CCAI, לוחצים על תפריט ואז על הגדרות > הגדרות למפתחים.

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

3. בדף ניהול חשבון אימייל, לוחצים על כניסה יחידה (SSO) לאימייל.

4. בחלונית Email SSO, מגדירים את ההגדרות שמופיעות ברשימה הבאה:

   • כתובת URL של הרשאה. מזינים https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent.

     חשוב: צריך להוסיף רווח לפני consent.

   • כתובת URL לטוקן. מזינים https://oauth2.googleapis.com/token.

   • Client ID. מזינים את מזהה הלקוח שיצרתם במאמר יצירת פרטי כניסה ל-OAuth. אם לא שמרתם את מזהה הלקוח, תוכלו לעיין במאמר איך מאתרים את מזהה הלקוח ואת הסוד של הלקוח.

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

   • היקף. מזינים https://mail.google.com/.

   • מדינה. משאירים את השדה הזה ריק.

   • סוג הגישה. מזינים offline.

   • סוג המענק. מזינים Authorization Code.

   • מבטלים את הסימון של תיבת הסימון Include the Grant Type as part of the Authorization URL and Token URL.

   • מסמנים את התיבה Include the Redirect URL as part of the Authorization URL and Token URL (הכללת כתובת הניתוב מחדש כחלק מכתובת ההרשאה וכתובת הטוקן), ואז לוחצים על Save (שמירה). ערוץ האימייל שלכם מוגדר ל-OAuth.