Active Directory

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

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

לפני שמשתמשים בכלי לחיבור ל-Active Directory, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

  • מידע על התקנה והגדרה של Active Directory זמין במאמר Active Directory Installation.

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. כלי לחיבור: בוחרים באפשרות Active Directory מהרשימה הנפתחת של כלי החיבור הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

    8. ‫DN בסיסי: החלק הבסיסי של השם הייחודי, שמשמש להגבלת התוצאות לענפים משניים ספציפיים.
    9. מנגנון אימות: מנגנון האימות שישמש לחיבור לשרת Active Directory.
    10. מעקב אחר הפניות: האם לעקוב אחר הפניות שמוחזרות על ידי שרת Active Directory.
    11. Friendly GUID: האם להחזיר ערכי מאפייני GUID בפורמט קריא.
    12. Friendly SID: האם להחזיר ערכים של מאפיין SID בפורמט קריא.
    13. גרסת LDAP: גרסת ה-LDAP שמשמשת לחיבור לשרת ולתקשורת איתו.
    14. היקף: האם להגביל את היקף החיפוש לכל עץ המשנה (BaseDN וכל הצאצאים שלו), לרמה אחת (BaseDN והצאצאים הישירים שלו) או לאובייקט הבסיס (BaseDN בלבד).
    15. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    16. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
    1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

    2. לוחצים על הבא.
  6. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      סוגי האימות הבאים נתמכים בחיבור ל-Active Directory:

      • שם משתמש וסיסמה

      2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    2. לוחצים על הבא.
  7. בדיקה: בודקים את פרטי החיבור והאימות.
  8. לוחצים על יצירה.

הגדרת אימות

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

  • שם משתמש וסיסמה
    • שם משתמש: שם המשתמש של המחבר
    • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.

דוגמאות להגדרת חיבור

בקטע הזה מפורטים ערכים לדוגמה לשדות השונים שאתם מגדירים כשאתם יוצרים חיבור ל-Active Directory.

סוג החיבור של שם משתמש וסיסמה

שם השדה פרטים
מיקום us-central1
מחבר Active Directory
גרסת המחבר 1
שם החיבור active-directory-google-cloud-vm-users-conn
הפעלת Cloud Logging כן
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
שם דומיין בסיסי BASE_DN
מנגנון אימות פשוט
גרסת LDAP 3
היקף WHOLESUBTREE
רמת הפירוט 5
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד(שרת) כתובת המארח
כתובת המארח ‫192.0.2.0
יציאה PORT
שם משתמש שם משתמש
סיסמה PASSWORD
גרסה של סוד 1

סוג החיבור SSL

שם השדה פרטים
מיקום us-central1
מחבר Active Directory
גרסת המחבר 1
שם החיבור active-directory-google-cloud-vm-ssl-conn
הפעלת Cloud Logging כן
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
שם דומיין בסיסי BASE_DN
מנגנון אימות פשוט
גרסת LDAP 3
היקף WHOLESUBTREE
רמת הפירוט 5
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
הפעל SSL כן
חיבור פרטי למאגר אישורים כן
סוג היעד(שרת) כתובת המארח
כתובת המארח ‫192.0.2.0
יציאה PORT
שם משתמש שם משתמש
סיסמה PASSWORD
גרסה של סוד 2

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

  • פעולה: פעולה היא הפעילות שאפשר לבצע בישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

    בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה Operations.

  • פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

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

מחבר Active Directory יכול לעבד 4 טרנזקציות בשנייה, לכל צומת, ומגביל טרנזקציות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

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

פעולות

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

פעולת MoveToDN

הפעולה הזו מעבירה אובייקט מ-DN אחד ל-DN אחר.

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

שם הפרמטר סוג נתונים חובה תיאור
DN String כן ה-DN הנוכחי של האובייקט שרוצים להעביר בשרת (לדוגמה, cn=Bob F,ou=Employees,dc=Domain).
NewParentDN String כן ה-DN החדש של האובייקט(לדוגמה, ou=Test Org,dc=Domain).

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

הפעולה GetAttributes

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

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

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

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

הפעולה AddMembersToGroup

הפעולה הזו מוסיפה חברים לקבוצה.

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

שם הפרמטר סוג נתונים חובה תיאור
GroupId String כן מזהה הקבוצה שאליה רוצים להוסיף את המשתמשים. צריך להיות המזהה של רשומת הקבוצה.
UserDNs String כן הטבלה המצטברת או הזמנית UserDNs שמכילה את ה-DN של המשתמשים שרוצים להוסיף לקבוצה. צריך להזין את ה-DN של רשומת המשתמש.

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

הפעולה RemoveMembersFromGroup

הפעולה הזו מסירה חברים מקבוצה.

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

שם הפרמטר סוג נתונים חובה תיאור
GroupId String כן מזהה הקבוצה שרוצים להסיר ממנה משתמשים. צריך להיות המזהה של רשומת הקבוצה.
UserDNs String כן הטבלה המצטברת או הזמנית UserDNs שמכילה את ה-DN של המשתמשים שרוצים להסיר מקבוצה. צריך להזין את ה-DN של רשומת המשתמש.

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

פעולת ResetPassword

הפעולה הזו מאפסת את הסיסמה.

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

שם הפרמטר סוג נתונים חובה תיאור
משתמש String כן ה-DN של החשבון שרוצים לשנות בשרת (לדוגמה, Domain\\BobF או cn=BobF,ou=Employees,dc=Domain)
NewPassword String כן הסיסמה החדשה של המשתמש שצוין על ידי DN.
AdminUser String כן חשבון אדמין או שם ייחודי (DN) שאליו יש לקשר את השרת (לדוגמה, Domain\\BobF או cn=BobF,ou=Employees,dc=Domain).
AdminPassword String כן סיסמה של חשבון אדמין שמשמשת לאימות בשרת LDAP.

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

הפעולה ChangePassword

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

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

שם הפרמטר סוג נתונים חובה תיאור
NewPassword String כן הסיסמה החדשה של המשתמש שצוין על ידי DN.

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

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

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

דוגמה – העברת אובייקט מ-DN אחד ל-DN אחר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה MoveToDN ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"NewParentDN": "CN=Users,DC=gcpad,DC=local",
"DN": "CN=GoogleAdmin,CN=Computers,DC=gcpad,DC=local"
}

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

    [{
"Success": null,
"result": "[ok]",
"modified": "true",
"rss:title": "The movement was successful.",
"resultcode": "0"
}]

דוגמה – קבלת מאפיינים של שם דומיין

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetAttributes ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"DN": "CN=admin,CN=Users,DC=test-ldap,DC=com"
}

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

    [{
"AttributeName": "_op",
"AttributeValue": "ldapadoGetAttributes"
},
{
"AttributeName": "msds-supportedencryptiontypes",
"AttributeValue": "24"
},
{
"AttributeName": "usncreated",
"AttributeValue": "12775"
},
{
"AttributeName": "objectclass",
"AttributeValue": "organizationalPerson"
},
{
"AttributeName": "objectclass",
"AttributeValue": "user"
},
{
"AttributeName": "accountexpires",
"AttributeValue": "9223372036854775807"
},
{
"AttributeName": "name",
"AttributeValue": "admin"
},
{
"AttributeName": "objectcategory",
"AttributeValue": "CN=Person,CN=Schema,CN=Configuration,DC=test-ldap,DC=com"
},
{
"AttributeName": null,
"AttributeValue": null
}]

דוגמה – הוספת חברים לקבוצה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddMembersToGroup ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"GroupId": "1|CN=GoogleGRP1fa2,CN=Users,DC=gcpad,DC=local",
"UserDNs": "[{\"DN\":\"CN=GoogleAI,CN=Users,DC=gcpad,DC=local;CN=Guest,CN=Users,DC=gcpad,DC=local\"}]"
}

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

    [{
"Success": "True"
}]

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה RemoveMembersFromGroup ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"GroupId": "1|CN=GoogleGRP1fa2,CN=Users,DC=gcpad,DC=local",
"UserDNs": "[{\"DN\":\"CN=GoogleAI,CN=Users,DC=gcpad,DC=local;CN=Guest,CN=Users,DC=gcpad,DC=local\"}]"
}

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

    [{
"Success": "True"
}]

דוגמה – איפוס סיסמה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה ResetPassword ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"AdminPassword": "XXXX=",
"User": "CN=GCP_Admin,CN=Users,DC=gcpad,DC=local",
"NewPassword": "XXXX",
"AdminUser": "CN=admin,CN=Users,DC=gcpad,DC=local"
}

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

    [{
"Success": "true",
"result": "[ok]",
"rss:title": "Password modified successfully",
"resultcode": "0"
}]

דוגמה – שינוי סיסמה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה ChangePassword ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"NewPassword": "XXXX"
}

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

    [{
"Success": "true",
"result": "[ok]",
"rss:title": "Password modified successfully.",
"resultcode": "0"
}]

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

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

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות User מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. אופציונלי: בקטע Task Input במשימה Connectors, אפשר לסנן את קבוצת התוצאות על ידי ציון filter clause. תמיד מציינים את הערך של סעיף המסנן בתוך גרשיים בודדים (').

    5. אפשר לבצע פעולת רשימה בישויות הבאות:

    קבוצה, חברות משתמש, חברות בקבוצה, OrganizationalPerson,‏ Person,‏ Top,‏ Organization,‏ OrganizationalRole,‏ DomainPolicy,‏ Contact,‏ Computer,‏ DnsNode,‏ SecurityObject,‏ OrganizationalUnit,‏ Domain ו-Account

דוגמה – שליפת רשומת משתמש

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות User מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על EntityId (מזהה ישות) ואז מזינים 1|CN=Active Directory User,DC=test-ldap,DC=com בשדה Default Value (ערך ברירת מחדל).

    כאן, 41|CN=Active Directory User,DC=test-ldap,DC=com הוא מזהה רשומה ייחודי בישות User.

    5. אפשר לבצע פעולת Get על הישויות הבאות:

    ‫Group,‏ User Membership,‏ Group Membership,‏ OrganizationalPerson,‏ Person,‏ Top,‏ SecurityPrincipal,‏ Organization,‏ OrganizationalRole,‏ DomainPolicy,‏ Contact,‏ Computer,‏ DnsNode,‏ SecurityObject,‏ OrganizationalUnit,‏ Domain ו-Account

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות User מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"RDN": "CN= Active Directory User ",
"ObjectClass": "top;person;organizationalPerson;user"
}

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=Administrator,CN=Users,DC=test-ldap,DC=com"
}

דוגמה – יצירת רשומה של מחשב

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Computer מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
"RDN": "CN=DELVM04S03",
"ObjectClass": "top;person;organizationalPerson;user;computer"
}

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

    {
"Id": "1|CN=DELVM04S03,CN=Computers,DC=gcpad,DC=local"
}

דוגמה – יצירת רשומת קבוצה (DomainLocal)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
"RDN": "CN=DomainLocala496",
"ObjectClass": "group",
"GroupType": "4"
}

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

    {
  "Id": "1|CN=DomainLocala496,CN=Users,DC=test-ldap,DC=com"
}

דוגמה – יצירת רשומה של קבוצה (גלובלית)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
  "RDN": "CN=Globalf862",
  "ObjectClass": "group",
  "GroupType": "-2147483646"
}

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

    {
  "Id": "1|CN=Globalf862,CN=Users,DC=test-ldap,DC=com"
}

דוגמה – יצירת רשומת קבוצה (אוניברסלית)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
  "RDN": "CN=UniversalGRP20e5",
  "ObjectClass": "group",
  "GroupType": "8"
}

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

    {
  "Id": "1|CN=UniversalGRP20e5,CN=Users,DC=test-ldap,DC=com"
}

דוגמה – יצירת רשומת קבוצה (אבטחה אוניברסלית)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
  "RDN": "CN=UniversalSecurity3f5a",
  "ObjectClass": "group",
  "GroupType": "-2147483640"
}

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

    {
  "Id": "1|CN=UniversalSecurity3f5a,CN=Users,DC=test-ldap,DC=com"
}

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות OrganizationPerson מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
  "RDN": "CN=OrgP_AD45237",
  "ObjectClass": "top;person;organizationalPerson;user;inetOrgPerson"
}

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

    {
  "Id": "1|CN=OrgP_AD45237,CN=Users,DC=gcpad,DC=local"
}

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Person מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
  "RDN": "CN=Personc3a",
  "ObjectClass": "top;person;organizationalPerson;user"
}

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

    {
  "Id": "1|CN=Personc3a,CN=Users,DC=gcpad,DC=local"
}

דוגמה – יצירת רשומה עליונה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Top מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
  "RDN": "CN=Top49b88",
  "ObjectClass": "top;person;organizationalPerson;user;inetOrgPerson"
}

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

    {
  "Id": "1|CN=Top49b88,CN=Users,DC=gcpad,DC=local"
}

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות User מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"PostalCode": "560048"
}

    5. במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1|CN=Active Directory User,DC=test-ldap,DC=com.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=Active Directory User,DC=test-ldap,DC=com"
}

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {
  "Member": "CN=admin,CN=Users,DC=test-ldap,DC=com;CN=Administrator,CN=Users,DC=test-ldap,DC=com"
}

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1|CN=ADGroup9bff,DC=test-ldap,DC=com.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=ADGroup9bff,DC=test-ldap,DC=com"
}

דוגמה – עדכון רשומה של קבוצה (GroupType)

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Group מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {
 "GroupType": "4"
}

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1|CN=UniversalGRP20e5,CN=Users,DC=test-ldap,DC=com.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=UniversalGRP20e5,CN=Users,DC=test-ldap,DC=com"
}

דוגמה – עדכון רשומה של OrganizationPerson

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות OrganizationPerson מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {
  "Title": "Test Engineer"
}

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1|CN=OrgP_ADa022f,DC=test-ldap,DC=com.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=OrgP_ADa022f,DC=test-ldap,DC=com"
}

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Person מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {
  "TelephoneNumber": "7764942992"
}

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1|CN=Person2e6,DC=test-ldap,DC=com.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=Person2e6,DC=test-ldap,DC=com"
}

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Top מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {
  "Description": "Top Testing GOOGLECLOUD"
}

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1|CN=Top3b6bc,DC=test-ldap,DC=com.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=Top3b6bc,DC=test-ldap,DC=com"
}

דוגמה – עדכון רשומת מחשב

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Computer מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {
"Description": "This is Windows 2019 Server."
}

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 1|CN=DELVM04S02,CN=Computers,DC=gcpad,DC=local.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
"Id": "1|CN=DELVM04S02,CN=Computers,DC=gcpad,DC=local"
}

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות User מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 1|CN=Active Directory User,DC=test-ldap,DC=com בשדה Default Value (ערך ברירת מחדל).

    5. אפשר לבצע פעולת מחיקה על הישויות הבאות:

    קבוצה, חברות משתמש, חברות בקבוצה, OrganizationalPerson,‏ Person,‏ Top,‏ Organization,‏ OrganizationalRole,‏ DomainPolicy,‏ Contact,‏ Computer,‏ DnsNode,‏ SecurityObject,‏ OrganizationalUnit,‏ Domain ו-Account

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

כדי לראות תבנית לדוגמה של Terraform ליצירת חיבור, אפשר לעיין בתבנית לדוגמה.

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:

שם הפרמטר סוג נתונים חובה תיאור
base_dn מחרוזת נכון החלק הבסיסי של השם הייחודי, שמשמש להגבלת התוצאות לעצי משנה ספציפיים.
auth_mechanism ENUM נכון מנגנון האימות שישמש לחיבור לשרת Active Directory. הערכים הנתמכים הם: SIMPLE, ‏ DIGESTMD5, ‏ NEGOTIATE
follow_referrals בוליאני לא נכון האם לעקוב אחרי הפניות שהוחזרו על ידי שרת Active Directory.
friendly_guid בוליאני לא נכון האם להחזיר ערכים של מאפייני GUID בפורמט קריא.
friendly_sid בוליאני לא נכון האם להחזיר ערכים של מאפיין SID בפורמט קריא.
ldapversion מחרוזת נכון גרסת ה-LDAP שמשמשת לחיבור לשרת ולתקשורת איתו.
היקף ENUM נכון האם להגביל את היקף החיפוש לעץ המשנה כולו (BaseDN וכל הצאצאים שלו), לרמה אחת (BaseDN והצאצאים הישירים שלו) או לאובייקט הבסיס (BaseDN בלבד). הערכים הנתמכים הם: WHOLESUBTREE, ‏ SINGLELEVEL, ‏ BASEOBJECT

שימוש בחיבור Active Directory בשילוב

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

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

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

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

המאמרים הבאים