გადადით შინაარსზე

SCIM პროვიზირება

Tuist მხარდაჭერას უწევს SCIM 2.0 პროვიზირებას, რათა იდენტობის პროვაიდერმა ავტომატურად შექმნას, განაახლოს და გააუქმოს ორგანიზაციის წევრები.

SCIM კონფიგურირდება თქვენი ორგანიზაციის პარამეტრებში Authentication ჩანართიდან. SCIM ტოკენი არის ორგანიზაციის საკუთრებაში არსებული ანგარიშის ტოკენი, რომელიც შეზღუდულია SCIM წვდომით და გამოჩნდება მხოლოდ ერთხელ გენერაციისას.

Note

SCIM აკონტროლებს წევრობას და სიცოცხლის ციკლს. ის არ ცვლის Single Sign-On-ს. კონფიგურაცია SSO-სთვის ცალკე გააკეთეთ, თუ პროვიზირებულ მომხმარებლებს ასევე უნდა შესძლებოდეთ შესვლა თქვენი იდენტობის პროვაიდერის მეშვეობით.

პროვიზირებული მომხმარებლები უკვე ორგანიზაციის წევრები არიან. როდესაც ისინი შედიან იგივე ელფოსტის მისამართით, ეს წევრობა შეიძლება გამოყენებულ იქნას ნდობის დასამყარებლად მათი პროვაიდერის იდენტობის დასაკავშირებლად. verified login email domain და enrollment policy აკონტროლებენ მომხმარებლებს, რომლებიც ჯერ არ არიან პროვიზირებული ან დამატებული ორგანიზაციაში.

Okta#

Okta Tuist-ისთვის იყენებს ორ ცალკეულ აპლიკაციას:

  • OIDC Web Application Tuist-ში შესასვლელად.
  • SCIM 2.0 Test App (Header Auth) აპლიკაცია მომხმარებლებისა და ჯგუფების Tuist-ში პროვიზირებისთვის.

ჯერ კონფიგურაცია გააკეთეთ Okta SSO-სთვის, თუ მომხმარებლებმა Okta-ს მეშვეობით უნდა შეძლონ შესვლა, შემდეგ კი ქვემოთ მოცემული ნაბიჯებით დააკონფიგურიროთ SCIM პროვიზირება.

ნაბიჯი 1: Tuist SCIM ტოკენის გენერირება#

  1. Tuist-ში გადადით თქვენი ორგანიზაციის Authentication პარამეტრების ჩანართზე.
  2. SCIM provisioning სექციაში დააკოპირეთ SCIM endpoint URL. ის უნდა მთავრდებოდეს /scim/v2-ით.
  3. დააჭირეთ Generate token-ს.
  4. მიანიჭეთ სახელი ტოკენს (მაგალითად, Okta).
  5. დააკოპირეთ გენერირებული ტოკენი. Tuist ტოკენს აჩვენებს მხოლოდ ერთხელ.

ნაბიჯი 2: Okta SCIM აპლიკაციის დამატება#

  1. თქვენს Okta ადმინისტრატორის დაფაზე გადადით Applications > Applications > Browse App Catalog-ზე.
  2. მოძებნეთ და დაამატეთ SCIM 2.0 Test App (Header Auth).
  3. მიანიჭეთ მას რაიმე ამოსაცნობი სახელი, მაგალითად Tuist SCIM.
  4. შეავსეთ შესვლის პარამეტრები SCIM სატესტო აპლიკაციისთვის. Tuist ამ აპლიკაციას შესვლისთვის არ იყენებს; შესვლას მართავს OIDC აპლიკაცია SSO სახელმძღვანელოდან.

ნაბიჯი 3: API ინტეგრაციის კონფიგურაცია#

  1. გახსენით SCIM აპლიკაციის Provisioning ჩანართი.
  2. Settings > Integration ქვეშ დააჭირეთ Configure API Integration ან Edit.
  3. მონიშნეთ Enable API integration.
  4. ჩასვით Tuist-ის SCIM endpoint URL Okta-ს Base URL ველში.
  5. ჩასვით Tuist SCIM ტოკენი API Token-ში, პრეფიქსით Bearer . მაგალითად, Bearer tuist_scim_.... Okta ამ ველს გზავნის როგორც Authorization ჰედერს, ხოლო Tuist ელოდება bearer ტოკენს.
  6. ჩართეთ Import Groups, თუ გსურთ, რომ Okta-მ წაიკითხოს Tuist-ის SCIM ჯგუფები.
  7. დააჭირეთ Test API Credentials-ს. Okta უნდა აჩვენოს, რომ ინტეგრაცია წარმატებით დადასტურდა.
  8. დააჭირეთ Save-ს.

ნაბიჯი 4: პროვიზირების მოქმედებების ჩართვა#

  1. SCIM აპლიკაციის Provisioning ჩანართში გახსენით Settings > To App.
  2. დააჭირეთ Edit-ს.
  3. ჩართეთ:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  4. დააჭირეთ Save-ს.

ნაბიჯი 5: მომხმარებლების ან ჯგუფების მინიჭება#

  1. გახსენით SCIM აპლიკაციის Assignments ჩანართი.
  2. მინიჭეთ ის მომხმარებლები ან ჯგუფები, რომლებიც Tuist-ში უნდა პროვიზირდეს.
  3. მიანიჭეთ იგივე მომხმარებლები ან ჯგუფები Okta OIDC აპლიკაციას, თუ მათ ასევე SSO-ით შესვლა უნდა შეეძლოთ.
  4. შეამოწმეთ Tuist-ის Members ჩანართი, რათა დარწმუნდეთ, რომ მინიჭებული მომხმარებლები ორგანიზაციაში ჩანან.

დეპროვიზირების შესამოწმებლად, გააუქმეთ ან გააუქციეთ მომხმარებელი Okta-ში და დარწმუნდით, რომ ის ქრება Tuist ორგანიზაციის Members ჩანართიდან.

როლების მინიჭება#

Tuist-ს აქვს სამი როლი: admin, user და viewer. Tuist თითოეული როლისთვის ერთ SCIM ჯგუფს წარმოადგენს: Tuist Admins, Tuist Users და Tuist Viewers. მიამაგრეთ Okta ჯგუფები მათ Group Push-ის საშუალებით:

  1. აირჩიეთ ან შექმენით Okta ჯგუფი თითოეული მინიჭებადი როლისთვის და მიანიჭეთ ეს ჯგუფები SCIM აპლიკაციის Assignments ჩანართზე.
  2. დარწმუნდით, რომ API ინტეგრაციაში ჩართულია Import Groups, შემდეგ გახსენით SCIM აპლიკაციის Import ჩანართი და დააჭირეთ Import Now-ს, რათა Okta-მ იცოდეს Tuist-ის ჯგუფების შესახებ.
  3. გახსენით SCIM აპლიკაციის Push Groups ჩანართი და დააჭირეთ Push Groups > Find groups by name-ს.
  4. აირჩიეთ Okta ჯგუფი, აირჩიეთ Link Group როგორც push-მოქმედება და აირჩიეთ შესაბამისი Tuist ჯგუფი. Tuist არ უჭერს მხარს ჯგუფების შექმნას SCIM-ის საშუალებით, ამიტომ ახლის შექმნის ნაცვლად დააკავშირეთ არსებულ ჯგუფთან.
  5. დააჭირეთ Save-ს და გაიმეორეთ დარჩენილი როლებისთვის.

მომხმარებლის დაკავშირებულ ჯგუფში დამატება ანიჭებს მას ამ როლს. ჯგუფიდან მისი ამოღება აბრუნებს მას იმ როლზე, რომლითაც ორგანიზაცია აერთიანებს ერთჯერადი შესვლის (SSO) წევრებს, რაც არის user, თუ ადმინისტრატორმა არ შეცვალა ის Settings > Authentication-ში. მომხმარებლები, რომლებიც არცერთ დაკავშირებულ ჯგუფში არ არიან, ასევე იღებენ ამ როლს. მომხმარებლის ჯგუფიდან ამოღება არ შლის მას ორგანიზაციიდან; ამისთვის გააუქმეთ ან გააუქციეთ ის Okta-ში.

Microsoft Entra ID#

Entra ID ახორციელებს Tuist-ის პროვიზირებას არა-გალერეის საწარმო აპლიკაციის საშუალებით. ჯერ კონფიგურირეთ Microsoft Entra ID SSO, თუ მომხმარებლებს ასევე Entra ID-ით შესვლა უნდა შეეძლოთ.

აპლიკაცია, რომელსაც ერთჯერადი შესვლისთვის ადრეგისტრირებთ და საწარმო აპლიკაცია, რომელსაც პროვიზირებისთვის იყენებთ, შეიძლება ერთი და იგივე იყოს. პროვიზირება კონფიგურირდება საწარმო აპლიკაციის ჩანაწერზე.

ნაბიჯი 1: Tuist SCIM ტოკენის გენერირება#

  1. Tuist-ში გადადით თქვენი ორგანიზაციის Authentication პარამეტრების ჩანართზე.
  2. SCIM provisioning სექციაში დააკოპირეთ SCIM endpoint URL. ის უნდა მთავრდებოდეს /scim/v2-ით.
  3. დააჭირეთ Generate token-ს.
  4. მიანიჭეთ სახელი ტოკენს (მაგალითად, Entra ID).
  5. დააკოპირეთ გენერირებული ტოკენი. Tuist ტოკენს მხოლოდ ერთხელ აჩვენებს.

ნაბიჯი 2: პროვიზირების კონფიგურაცია#

  1. Microsoft Entra admin center-ში გადადით Identity > Applications > Enterprise applications-ზე და გახსენით Tuist აპლიკაცია.
  2. გახსენით Provisioning და დააყენეთ Provisioning Mode მნიშვნელობაზე Automatic.
  3. დააყენეთ Tenant URL Tuist SCIM ბოლოწერტილის URL-ზე.
  4. დააყენეთ Secret Token Tuist SCIM ტოკენზე. შეიყვანეთ ტოკენი ცალკე, Bearer პრეფიქსის გარეშე; Entra ID სქემას თავად დაამატებს.
  5. დააჭირეთ Test Connection-ს. Entra ID უნდა აჩვენოს, რომ მიწოდებული სერთიფიკატები ავტორიზებულია.
  6. შეინახეთ კონფიგურაცია.

ნაბიჯი 3: შესაბამისობის ატრიბუტის დაყენება#

  1. Mappings-ის ქვეშ გახსენით Provision Microsoft Entra ID Users.
  2. დარწმუნდით, რომ userPrincipalName ან mail ასახავს SCIM userName ატრიბუტს და რომ ეს ატრიბუტი გამოიყენება Matching precedence 1-ისთვის.
  3. ამოიღეთ externalId შესაბამისობის ატრიბუტებიდან, თუ ის არსებობს.

Tuist პროვიზირებულ მომხმარებლებს userName-ით ადარებს. ის არ ინახავს დირექტორიის ობიექტის იდენტიფიკატორს, რომელსაც Entra ID გზავნის როგორც externalId, ამიტომ ამ ატრიბუტზე ფილტრი არსებულ წევრს ვერ პოულობს და პროვიზირების ციკლებმა შეიძლება არაპროგნოზირებადად იმოქმედონ.

ნაბიჯი 4: ჯგუფების პროვიზირების გამორთვა#

Mappings-ის ქვეშ, დააყენეთ Provision Microsoft Entra ID Groups გამორთულ მდგომარეობაზე.

Tuist-ის SCIM ჯგუფები არის ფიქსირებული ჯგუფი თითოეული ორგანიზაციის როლისთვის და არა დირექტორიის ჯგუფები, რომელთა შექმნაც შეგიძლიათ, ამიტომ დირექტორიის ჯგუფის პროვიზირების მცდელობა ვერ ხერხდება. ამის ნაცვლად მიანიჭეთ როლები ქვემოთ აღწერილი წესით.

ნაბიჯი 5: მომხმარებლების მინიჭება და პროვიზირების დაწყება#

  1. გახსენით აპლიკაციის Users and groups ჩანართი და მიანიჭეთ მომხმარებლები ან ჯგუფები, რომლებიც Tuist-ში უნდა პროვიზირდეს.
  2. დაუბრუნდით Provisioning-ს და დაიწყეთ ის.
  3. შეამოწმეთ Tuist-ის Members ჩანართი, რათა დარწმუნდეთ, რომ მინიჭებული მომხმარებლები ორგანიზაციაში ჩანან.

Entra ID პროვიზირებას ახორციელებს საკუთარი განრიგით, რაც ჩვეულებრივ ყოველ 40 წუთში ხდება, ამიტომ წევრები მყისიერად არ ჩანან. ერთი მომხმარებლის დაუყოვნებლივ შესამოწმებლად გამოიყენეთ Provision on demand.

პროვიზირების გაუქმების შესამოწმებლად, Entra ID-ში გააუქმეთ ან გამორთეთ მომხმარებელი და დარწმუნდით, რომ ის გაქრა Tuist ორგანიზაციის Members ჩანართიდან.

თუ მოგვიანებით შეცვლით პროვიზირების ფარგლებს, მაგალითად Sync all users and groups-დან Sync only assigned users and groups-ზე, შემდეგ დააჭირეთ Restart provisioning. Entra ID ახალ ფარგლებს, მათ შორის იმ მომხმარებლების პროვიზირების გაუქმებას, ვინც აღარ შედის მასში, მხოლოდ გადატვირთვის შემდეგ გამოიყენებს.

როლების მინიჭება#

Tuist-ს აქვს სამი როლი: admin, user და viewer. მათი Entra ID-დან დასაყენებლად:

  1. App registrations-ში გახსენით Tuist აპლიკაცია და დაამატეთ აპლიკაციის როლი თითოეული Tuist როლისთვის, რომლის მინიჭებაც გსურთ. დააყენეთ Allowed member types მნიშვნელობაზე Users/Groups და Value — admin, user ან viewer.
  2. საწარმო აპლიკაციის Users and groups ჩანართზე მიანიჭეთ თითოეულ მომხმარებელს ან ჯგუფს ერთ-ერთი ამ აპლიკაციის როლი. მომხმარებელს შეიძლება ჰქონდეს რამდენიმე აპლიკაციის როლი. Tuist იყენებს ყველაზე მაღალი პრივილეგიის მქონე როლს, სადაც admin უფრო მაღალია ვიდრე user და user უფრო მაღალია ვიდრე viewer, ამიტომ მომხმარებელი, რომელიც სხვადასხვა როლზე ასახულ ჯგუფებს ეკუთვნის, იღებს მათ შორის უმაღლესს.
  3. Provisioning > Mappings-ის ქვეშ, გახსენით Advanced Options ჩამოსაშლელი მენიუ და აირჩიეთ Edit target User attributes. დაამატეთ ატრიბუტი სახელით roles, სადაც Type დაყენებულია String-ზე და Multi-Value მონიშნულია.
  4. Provisioning > Mappings > Provision Microsoft Entra ID Users-ის ქვეშ, დააჭირეთ Add New Mapping. დააყენეთ Mapping type მნიშვნელობაზე Expression, Expression — AssertiveAppRoleAssignmentsComplex([appRoleAssignments])-ზე, ხოლო Target attribute — თქვენს მიერ დამატებულ roles ატრიბუტზე.
  5. პროვიზირების ფარგლები დატოვეთ დაყენებული Sync only assigned users and groups-ზე. AssertiveAppRoleAssignmentsComplex არ არის თავსებადი Sync all users and groups-თან.

AssertiveAppRoleAssignmentsComplex გზავნის ყველა აპლიკაციის როლს, რომელიც მომხმარებელს აქვს, ასევე გზავნის წაშლებს, ამიტომ როლის წართმევა Entra ID-ში ამცირებს მომხმარებლის უფლებებს იმ ყველაზე მაღალ პრივილეგიურ როლამდე, რომელიც მას კვლავ აქვს. SingleAppRoleAssignment([appRoleAssignments]), რომელიც ასახულია roles[primary eq "True"].value-ზე, ასევე მუშაობს, მაგრამ ის ყოველთვის მხოლოდ ერთ როლს გზავნის და Entra ID არ იძლევა გარანტიას, თუ რომელს აირჩევს, როცა მომხმარებელს რამდენიმე როლი აქვს.

მომხმარებლის აპლიკაციის როლების შეცვლა Entra ID-ში აახლებს მათ Tuist როლს შემდეგი პროვიზირების ციკლის დროს. მომხმარებელი, რომელიც პროვიზირებულია აპლიკაციის როლის გარეშე ან admin, user ან viewer-ისგან განსხვავებული მნიშვნელობებით, იღებს იმ როლს, რომლითაც ორგანიზაცია აფორმებს ერთჯერადი შესვლის (SSO) წევრებს, რაც არის user, თუ ადმინისტრატორმა არ შეცვალა ეს Settings > Authentication-ში.

სიცოცხლის ციკლის ქცევა#

როდესაც თქვენი იდენტობის პროვაიდერი მომხმარებელს პროვიზირების აპლიკაციას მიაკუთვნებს, Tuist ქმნის მომხმარებელს, თუ ელფოსტა Tuist-ისთვის ჯერ არ არის ცნობილი, შემდეგ კი მას ორგანიზაციას უმატებს. თუ ელფოსტა უკვე ეკუთვნის არსებულ Tuist მომხმარებელს ორგანიზაციის გარეთ, Tuist ამ მომხმარებელს უმატებს და აგზავნის შეტყობინებას ამის შესახებ, თუ არა სხვა ორგანიზაციის SCIM ინტეგრაციამ შექმნა ანგარიში. ამ შემთხვევაში Tuist უარყოფს მოთხოვნას 409-ით, რათა იდენტობის პროვაიდერმა ვერ მიისაკუთროს ანგარიში, რომელსაც სხვა ორგანიზაცია მართავს.

თქვენს იდენტობის პროვაიდერს შეუძლია შეცვალოს მომხმარებლის ელფოსტა (userName) მხოლოდ მაშინ, როცა თქვენი ორგანიზაცია ანგარიშს დამოუკიდებლად მართავს. ეს ნიშნავს, რომ Tuist-მა შექმნა ანგარიში თქვენი SCIM ინტეგრაციის მეშვეობით და ამის შემდეგ მომხმარებელს არ დაუყენებია პაროლი, არ შესულა პროვაიდერით, რომელიც განსხვავდება თქვენი ორგანიზაციის ერთჯერადი შესვლისგან, არ მოითხოვა აგენტის რეგისტრაცია ან არ შეუერთდა სხვა ორგანიზაციას. ნებისმიერი სხვა მომხმარებლისთვის Tuist უარყოფს ცვლილებას 400-ით და mutability SCIM შეცდომის ტიპით. ის მაინც გამოიყენებს იმავე მოთხოვნაში გაგზავნილ დეაქტივაციას. Tuist ასევე უარს ამბობს მომხმარებლების შექმნაზე ან გადასახელებაზე შესვლის დომენში, რომელიც სხვა ორგანიზაციამ დაადასტურა, და tuist.dev-ზე, Tuist-ის საკუთარ დომენში. გადასახელება ასუფთავებს ჩანაწერს იმის შესახებ, რომ მომხმარებელმა დაადასტურა ძველი მისამართის კონტროლი.

როდესაც თქვენი იდენტობის პროვაიდერი მომხმარებელს აუქმებს ან დეაქტივირებს, Tuist აშორებს მათ ორგანიზაციის როლს, თუმცა ინარჩუნებს მომხმარებლის ჩანაწერს და მათ მიერ შესრულებულ ნამუშევარს. პროვიზირების გაუქმება არ თიშავს მომხმარებელს გლობალურად, რადგან იგივე Tuist მომხმარებელი შეიძლება ეკუთვნოდეს სხვა ორგანიზაციებს.

Tuist წარმოადგენს სამ სინთეზურ SCIM ჯგუფს: Tuist Admins, Tuist Users და Tuist Viewers. ჯგუფში წევრის დამატება აყენებს მათ ორგანიზაციის როლს. წევრის იმ ჯგუფიდან წაშლა, რომელიც შეესაბამება მათ ამჟამინდელ როლს, აბრუნებს მათ დარეგისტრირების როლზე, ხოლო წევრობა თავად მხოლოდ მაშინ სრულდება, როცა მომხმარებელი გაუქმებულია ან დეაქტივირებული. იდენტობის პროვაიდერებს ასევე შეუძლიათ დააყენონ როლი SCIM roles ატრიბუტის მეშვეობით მომხმარებელზე, მნიშვნელობით admin, user ან viewer. იდენტობის პროვაიდერი, რომელიც რამდენიმე მნიშვნელობას გზავნის, იღებს მათ შორის ყველაზე მაღალი პრივილეგიის მქონეს, სადაც admin უფრო მაღალია ვიდრე user და user უფრო მაღალია ვიდრე viewer.

მხარდაჭერილი SCIM ფუნქციები#

Tuist მხარს უჭერს SCIM 2.0 ბოლოწერტილებს, რომლებიც იდენტობის პროვაიდერებს სჭირდებათ სიცოცხლის ციკლის მართვისთვის:

  • POST, GET, PUT, PATCH და DELETE /Users-ისთვის.
  • GET და PATCH /Groups-ისთვის.
  • SCIM აღმოჩენის ბოლოწერტილები /ServiceProviderConfig, /ResourceTypes და /Schemas-ისთვის.