‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Okta

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

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

בפרויקט Google Cloud, מבצעים את המשימות הבאות:

מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
מקצים את התפקידים roles/secretmanager.viewer ו-roles/secretmanager.secretAccessor ב-IAM לחשבון השירות שבו רוצים להשתמש עבור המחבר.
מפעילים את השירותים הבאים:
- ‫secretmanager.googleapis.com (Secret Manager API)
- ‫connectors.googleapis.com (Connectors API)
במאמר הפעלת שירותים מוסבר איך להפעיל שירותים. אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.

יצירת חיבור Okta

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

במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
כניסה לדף Connections
לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
בקטע מיקום, בוחרים את המיקום של החיבור.
1. אזור: בוחרים מיקום מהרשימה הנפתחת.
  רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
2. לוחצים על הבא.
בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
1. ברשימה Connector (מחבר), בוחרים באפשרות Okta.
2. בוחרים גרסה של מחבר מהרשימה Connector version (גרסת המחבר).
3. בשדה Connection Name, מזינים שם למופע החיבור. שם החיבור יכול להכיל אותיות קטנות, מספרים או מקפים. השם צריך להתחיל באות ולהסתיים באות או במספר, והוא לא יכול להכיל יותר מ-49 תווים.
4. אפשר גם להזין תיאור למופע החיבור.
5. אופציונלי: מפעילים את Cloud logging ובוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
7. Domain (דומיין): מזינים דומיין Okta כדי להתחבר למופע Okta.
8. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
9. לוחצים על הבא.
בקטע אימות, מזינים את פרטי האימות.
1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
  החיבור ל-Okta תומך בסוגי האימות הבאים:
  - ‫OAuth 2.0 – קוד הרשאה
  - פרטי כניסה של לקוח ב-OAuth 2.0 עם JWT bearer
2. לוחצים על הבא.
בדיקה: בודקים את פרטי החיבור והאימות.
לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

OAuth 2.0 – קוד הרשאה
- Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
- ‫Scopes: רשימה מופרדת בפסיקים של ההיקפים הרצויים.
- סוד הלקוח: סוד הלקוח שמשמש לבקשת אסימוני גישה.
- כתובת URL לאישור: כתובת ה-URL לאישור שנוצרת כשיוצרים לקוח.

בסוג האימות Authorization code, אחרי שיוצרים את החיבור, צריך לבצע כמה שלבים נוספים כדי להגדיר את האימות. מידע נוסף זמין במאמר שלבים נוספים אחרי יצירת החיבור.

‫OAuth 2.0 – פרטי כניסה של לקוח עם JWT bearer
- Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
- ‫Scopes: רשימה מופרדת בפסיקים של ההיקפים הרצויים.
- מפתח פרטי: סוד ב-Secret Manager שמכיל את התוכן של קובץ המפתח הפרטי בפורמט PEM. המפתח הפרטי חייב להיות תואם למפתח הציבורי או לאישור.

שלבים נוספים אחרי יצירת החיבור

אם בחרתם באפשרות OAuth 2.0 - Authorization code לאימות, אתם צריכים לבצע את השלבים הנוספים הבאים אחרי יצירת החיבור:

בדף החיבורים, מאתרים את החיבור החדש.
שימו לב שהסטטוס של המחבר החדש יהיה נדרשת הרשאה.
לוחצים על דרושה הרשאה.
יוצג לוח עריכת הרשאה.
מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית.
מאמתים את פרטי ההרשאה.
לוחצים על Authorize.
אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

אישור מחדש של קוד הרשאה

אם אתם משתמשים בסוג האימות Authorization code וביצעתם שינויים בהגדרות, אתם צריכים לאשר מחדש את החיבור שלכם ל-Okta. כדי לחדש את הרשאת הגישה לחיבור:

לוחצים על החיבור הרצוי בדף החיבורים.
ייפתח הדף עם פרטי החיבור.
לוחצים על עריכה כדי לערוך את פרטי החיבור.
בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.
אם צריך, מבצעים את השינויים הנדרשים.
לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
לוחצים על Authorize.
אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

מגבלות המערכת

מחבר Okta יכול לעבד עד עסקה אחת בשנייה, לכל צומת, ומגביל את מספר העסקאות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

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

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

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

שימוש בחיבור Okta בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור באינטגרציה באמצעות המשימה Connectors.

כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
מידע על יצירה ושימוש במשימת Connectors ב-Application Integration זמין במאמר משימת Connectors.

פעולות

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

פעולה ReactivateUser

הפעולה הזו מפעילה מחדש את המשתמש.

פרמטרים של קלט של הפעולה ReactivateUser

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.

לדוגמה להגדרת הפעולה ReactivateUser, ראו ActivateUser Example.

ActivateUser action

הפעולה הזו מפעילה משתמש.

פרמטרים של קלט לפעולה ActivateUser

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.

לדוגמה להגדרת הפעולה ActivateUser, ראו ActivateUser Example.

פעולת השבתת משתמש

הפעולה הזו משביתה את המשתמש.

פרמטרים של קלט לפעולה DeactivateUser

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.

לדוגמה להגדרת הפעולה DeactivateUser, ראו DeactivateUser Example.

פעולה של הקצאת משתמש לקבוצה

הפעולה הזו מקצה משתמש לקבוצה.

פרמטרים של קלט לפעולה Assignusertogroup

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.
GroupID	String	True	המזהה של הקבוצה.

דוגמה להגדרת הפעולה Assignusertogroup מופיעה במאמר Assignusertogroup Example.

הפעולה UnassignUsertoRole

הפעולה הזו מבטלת את ההקצאה של משתמש לתפקיד.

פרמטרים של קלט לפעולה UnassignUsertoRole

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.
RoleAssignmentId	String	True	המזהה של התפקיד.

דוגמה להגדרת הפעולה UnassignUsertoRole מופיעה במאמר דוגמה לביטול הקצאת משתמש לתפקיד.

הפעולה AssignUsertoRole

הפעולה הזו מקצה משתמש לתפקיד.

פרמטרים של קלט לפעולה AssignUsertoRole

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.
RoleId	String	True	המזהה של התפקיד.

דוגמה להגדרת הפעולה AssignUsertoRole מופיעה במאמר דוגמה להקצאת משתמש לתפקיד.

הפעולה AssignUsertoApp

הפעולה הזו מקצה משתמש לאפליקציה.

פרמטרים של קלט לפעולה AssignUsertoApp

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.
AppId	String	True	מזהה האפליקציה.

דוגמה להגדרת הפעולה AssignUsertoApp מופיעה במאמר AssignUsertoApp Example.

הפעולה UnassignUsertoGroup

הפעולה הזו מבטלת את ההקצאה של משתמש לקבוצה.

פרמטרים של קלט לפעולה UnassignUsertoGroup

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.
GroupID	String	True	המזהה של הקבוצה.

לדוגמה להגדרת הפעולה UnassignUsertoGroup, אפשר לעיין במאמר UnassignUsertoGroup Example.

פעולת ביטול ההקצאה של משתמש לאפליקציה

הפעולה הזו מבטלת את ההקצאה של משתמש לאפליקציה.

פרמטרים של קלט לפעולה UnassignUsertoApp

שם הפרמטר	סוג נתונים	חובה	תיאור
UserID	String	True	המזהה של המשתמש.
AppID	String	True	מזהה האפליקציה.

דוגמה להגדרת הפעולה UnassignUsertoApp מופיעה במאמר דוגמה לביטול הקצאת משתמש לאפליקציה.

פעולה של הקצאת קבוצה לאפליקציה

הפעולה הזו מקצה קבוצה לאפליקציה.

פרמטרים של קלט לפעולה Assigngrouptoapp

שם הפרמטר	סוג נתונים	חובה	תיאור
GroupId	String	True	המזהה של הקבוצה.
AppID	String	True	מזהה האפליקציה.

דוגמה להגדרת הפעולה Assigngrouptoapp מופיעה במאמר Assigngrouptoapp Example.

הפעולה AssignGrouptoRole

הפעולה הזו מקצה קבוצה לתפקיד.

פרמטרים של קלט לפעולה AssignGrouptoRole

שם הפרמטר	סוג נתונים	חובה	תיאור
GroupId	String	True	המזהה של הקבוצה
RoleId	String	True	המזהה של התפקיד
TypeId	String	True	המזהה של הסוג

דוגמה להגדרת הפעולה AssignGrouptoRole מופיעה במאמר AssignGrouptoRole Example.

פעולה UnassignGrouptoApp

הפעולה הזו מבטלת את ההקצאה של קבוצה לאפליקציה.

פרמטרים של קלט לפעולה UnassignGrouptoApp

שם הפרמטר	סוג נתונים	חובה	תיאור
קבוצה	String	True	המזהה של GroupId
AppID	String	True	מזהה האפליקציה

דוגמה להגדרת הפעולה UnassignGrouptoApp מופיעה במאמר UnassignGrouptoApp Example.

הפעולה UnassignGrouptoRole

הפעולה הזו מבטלת את ההקצאה של קבוצה לתפקיד.

פרמטרים של קלט לפעולה UnassignGrouptoRole

שם הפרמטר	סוג נתונים	חובה	תיאור
קבוצה	String	True	המזהה של GroupId
AppID	String	True	המזהה של AppId

לדוגמה להגדרת הפעולה UnassignGrouptoRole, ראו דוגמה לביטול ההקצאה של קבוצה לתפקיד.

הפעולה SuspendUser

הפעולה הזו משעה את המשתמש.

פרמטרים של קלט לפעולה SuspendUser

שם הפרמטר	סוג נתונים	חובה	תיאור
קבוצה	String	True	המזהה של GroupId.
AppID	String	True	המזהה של AppId.

לדוגמה להגדרת הפעולה SuspendUser, ראו דוגמה ל-SuspendUser.

פעולת UnsuspendUser

הפעולה הזו מבטלת את ההשעיה של המשתמש.

פרמטרים של קלט לפעולה UnsuspendUser

שם הפרמטר	סוג נתונים	חובה	תיאור
קבוצה	String	True	המזהה של GroupId.
AppID	String	True	המזהה של AppId.

לדוגמה להגדרת הפעולה UnsuspendUser, ראו דוגמה לביטול השעיה של משתמש.

דוגמאות לפעולות

דוגמה – הפעלה מחדש של משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה ReactivateUser ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה ReactivateUser של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{ 
    "Status": "Success",
    "ActivationToken": "PKeQTJMUW9vg0wyh8czA",
    "ActivationUrl": "https://dev-99779501.okta.com/tokens/PKeQTJMUW9vg0wyh8czA/verify" 
}

דוגמה – הפעלת משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה ActivateUser ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה ActivateUser של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{ 
  "Status": "Success",
    "activationurl": null,
    "activationtoken": null
}

דוגמה – השבתת משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה DeactivateUser ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה DeactivateUser של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{ 
 "Status": "Success",
"activationurl": null,
"activationtoken": null 
}

דוגמה – הקצאת משתמש לקבוצה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה Assignusertogroup ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7",
    "GroupId": "7463874b834938475d"
}
```

אם הפעולה מצליחה, לפרמטר התגובה Assignusertogroup של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
 "Status": "Success",
}

דוגמה – ביטול הקצאת תפקיד למשתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה UnassignUsertoRole ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "RoleAssignmentId": "irblawnjpom1bLBcJ5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה UnassignUsertoRole של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
 "Status": "Success",
}

דוגמה – הקצאת משתמש לתפקיד

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה AssignUsertoRole ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
"UserId": "00ukxucmpl25SNLP65d7",
"RoleId": "cr0l2n9ay0pCCxLgG5d7",
"ResourceSet": "iaml81kep6zefR4Oq5d7",
"Type": "CUSTOM"
}
```

אם הפעולה מצליחה, לפרמטר התגובה AssignUsertoRole של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
 "Status": "Success",
    "Id": "irblawfe99RsUfILD5d7",
    "Label": "UserCreatorByabhishkePostman",
    "Type": "CUSTOM", 
    "Created": "2024-11-21 07:33:05.0",
    "LastUpdated": "2024-11-21 07:33:05.0",
    "AssignmentStatus": "ACTIVE",
    "AssignmentType": "USER",
    "resource-set": "iaml81kep6zefR4Oq5d7",
    "role": "cr0l2n9ay0pCCxLgG5d7",
    "_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7",
    "_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7",
    "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7/permissions",
    "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l2n9ay0pCCxLgG5d7/members/irblawfe99RsUfILD5d7",
    "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

דוגמה – הקצאת משתמש לאפליקציה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה AssignUsertoApp ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה AssignUsertoApp של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
    "Status": "Success",
    "Id": "00ukxucmpl25SNLP65d7",
    "Created": "2024-11-21 07:08:40.0",
    "LastUpdated": "2024-11-21 07:08:45.0",
    "Scope": "USER",
    "AssignmentStatus": "ACTIVE",
    "externalid": null, 
    "statuschanged": "2024-11-21T07:08:40.000Z",
    "passwordchanged": null,
    "syncstate": "DISABLED",
    "credentials_username": "baklavainthebalkans@gmail.com",
    "profile_street_address": null,
    "profile_country": null, 
    "profile_website": null,
    "profile_zoneinfo": "America/Los_Angeles",
    "profile_birthdate": null,
    "profile_gender": null,
    "profile_formatted": null,
    "profile_profile": null,
    "profile_locality": null,
    "profile_given_name": "Baklavainthe",
    "profile_middle_name": null,
    le_phone_number": null,
    "profile_region": null,
    "profile_postal_code": null,
    "profile_family_name": "Balkans",
    "profile_email": "baklavainthebalkans@gmail.com",
    "_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7", 
    "_links_user_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

דוגמה – ביטול ההקצאה של משתמש לקבוצה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה UnassignUsertoGroup ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "GroupId": "0oakn3j0bfGPR1Esk5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה UnassignUsertoGroup של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
"Status": "Success"
}

דוגמה – ביטול הקצאת משתמש לאפליקציה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה UnassignUsertoApp ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה UnassignUsertoApp של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
{
"Status": "Success"
}

דוגמה – הקצאת קבוצה לאפליקציה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה Assigngrouptoapp ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
   "GroupId": "00gl5wovm8GuLr8vg5d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה Assigngrouptoapp של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
"Status": "Success",
"Id": "00gl5wovm8GuLr8vg5d7",
"LastUpdated": "2024-11-21 08:42:53.0",
"Priority": 0,
"_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7",
"_links_self_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7/groups/00gl5wovm8GuLr8vg5d7", "_links_group_href": "https://dev-99779501.okta.com/api/v1/groups/00gl5wovm8GuLr8vg5d7"
}

דוגמה – הקצאת קבוצה לתפקיד

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה AssignGrouptoRole ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
"GroupId": "00gl9xqojqXq0TJgS5d7",
"RoleId": "cr0l5tqddvkDtcfPl5d7",
"Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה AssignGrouptoRole של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
"Status": "Success",
"Id": "irbla1k8uy8XxDDFF5d7",
"Label": "ReadAdmin_Altostrat",
"Type": "CUSTOM",
"Created": "2024-11-20 12:28:33.0",
"LastUpdated": "2024-11-20 12:28:33.0",
"AssignmentStatus": "ACTIVE",
"AssignmentType": "GROUP",
"resource-set": "iaml81kep6zefR4Oq5d7",
"role": "cr0l5tqddvkDtcfPl5d7",
"_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7",
"_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7", "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7/permissions", "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l5tqddvkDtcfPl5d7/members/irbla1k8uy8XxDDFF5d7", "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/groups/00gl9xqojqXq0TJgS5d7"
}

דוגמה – ביטול ההקצאה של קבוצה לאפליקציה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה UnassignGrouptoApp ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
 "GroupId": "00gl5wovm8GuLr8vg5d7",
 "AppId": "0oakn3j0bfGPR1Esk5d7" 
}
```

אם הפעולה מצליחה, לפרמטר התגובה UnassignGrouptoApp של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
"Status": "Success"
}

דוגמה – ביטול הקצאת תפקיד לקבוצה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה UnassignGrouptoRole ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
"GroupId": "00gl5wovm8GuLr8vg5d7",
"RoleAssignmentId": "irbl94sbyit77SGpg5d7"
}
```

אם הפעולה מצליחה, לפרמטר התגובה UnassignGrouptoRole של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
"Status": "Success"
}

דוגמה – השעיית משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה SuspendUser ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
"UserId": "00ulkdsubxO6W6LgJ5d7" 
}
```

אם הפעולה מצליחה, לפרמטר התגובה SuspendUser של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
"Status": "Success"
}

דוגמה – ביטול השעיה של משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה UnsuspendUser ולוחצים על סיום.
בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
{
"UserId": "00ulkdsubxO6W6LgJ5d7" 
}
```

אם הפעולה מצליחה, לפרמטר התגובה UnsuspendUser של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

{
"Status": "Success"
}

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

דוגמה – הצגת רשימה של כל המשתמשים

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות 'משתמשים' מהרשימה Entity.
בוחרים את הפעולה List ולוחצים על סיום.
בקטע Task Input (קלט למשימה) של המשימה Connectors (מחברים), אפשר להגדיר את filterClause (סעיף מסנן) בהתאם לדרישות.

חובה להשתמש במירכאות בודדות (') כדי להקיף את הערך של פסקה של מסנן. אפשר להשתמש בסעיף המסנן כדי לסנן רשומות על סמך העמודות.

דוגמה – קבלת משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Users מהרשימה Entity.
בוחרים את הפעולה Get ולוחצים על סיום.
מגדירים את מזהה הישות ל-20001, שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "20001" בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

חובה להעביר את מזהה הישות ישירות, למשל '20001'. כאן, הערך '20001' הוא ערך המפתח הראשי הייחודי, שמועבר

חובה להשתמש בסעיף filter בשאילתות שבהן העברת מזהה של ישות תגרום לשגיאה, כי יהיו שני מפתחות מורכבים, כמו id='20001'

דוגמה – מחיקת משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Users מהרשימה Entity.
בוחרים את הפעולה Delete ולוחצים על סיום.
מגדירים את מזהה הישות לערך '00ul7l5fdyTdHDfSj5d7', שהוא המפתח שיועבר.כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "20001" בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId (מזהה ישות) כמשתנה מקומי.
אם לישות יש שני מפתחות עסקיים או מפתחות ראשיים מורכבים, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל-id='00ul7l5fdyTdHDfSj5d7'.

דוגמה – יצירת משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Users מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
{ "ProfileFirstName": "Test",
    "ProfileLastName": "Test User",
    "ProfileEmail": "Test@gmail.com",
    "ProfileLogin": "Test11@example.com"
}
```
אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Vendor יהיה ערך שדומה לזה:
```
{
    "Id": "00ula502hjbwWYsO25d7"
}
```

דוגמה – יצירת קבוצה

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Groups מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
{
    "ProfileDescription": "Googlecloud group",
    "ProfileName": "Goolecloud created grp\n"
}
```
אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה APBill יהיה ערך שדומה לזה:
```
{
    "Id": "00gl7lb5gniIAOMwA5d7"
}
```

דוגמה – יצירת אפליקציה

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Apps מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
{ "Label": "Googlecloud generated app",
    "SignOnMode": "AUTO_LOGIN",
    "AutoSubmitToolbar": false,
    "Settings": "{\"signOn\":{\"redirectUrl\":\"https://www.example.com\",\"loginUrl\":\"https://www.example.com\"}}"
}
```
בדוגמה הזו נוצרת התכונה Vendtype. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Vendtype יהיה ערך שדומה לזה:
```
{
    "Id": "0oal9vwooxEXXpdjS5d7"
}
```

דוגמה – יצירת תפקיד

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Roles מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי.
```
{ "Label": "new role2", 
    "Description": "GABA Role1",
    "Permissions": "\"okta.users.read\", \"okta.groups.read\"" 
}
```
אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Customer יהיה ערך שדומה לזה:
```
{
    "Id": "cr0l824rbiTvtJDoi5d7"
}
```

דוגמה – עדכון משתמש

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Users מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
{
    "ProfileFirstName": "ShubhGillL" 
}
```
מגדירים את מזהה הישות בכלי למיפוי נתונים לישות של המשתמשים. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 20044.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
{
    "Id": "00ul7u8cyobt8SGRK5d7" 
}
```

דוגמה – עדכון של קבוצה

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Groups מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
{
    "ProfileName": "Updated Googlecloud group"
}
```
מגדירים את מזהה הישות בכלי למיפוי נתונים לישות של הקבוצות. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1371.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
{
    "Id": "00gl92veg4VSQQb5A5d7"
}
```

דוגמה – עדכון אפליקציה

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Apps מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
{
    "Label": "Googlecloud updated label"
}
```
מגדירים את מזהה הישות בכלי למיפוי נתונים לישות של שירותי Google. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך Customerid='10100'\n.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
{
    "Id": "0oal9vwooxEXXpdjS5d7"
}
```

דוגמה – עדכון תפקיד

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Roles מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
```
{
    "Label": "Googlecloud updated label"
}
```
מגדירים את מזהה הישות ב-Data Mapper לישות של התפקידים. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.
במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1.

הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
{
    "Id": "cr0l7dqeatRuIrn5x5d7"
}
```

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.