System zarządzania tożsamością w wielu domenach (System for Cross-domain Identity Management, SCIM) to protokół do zarządzania użytkownikami w wielu aplikacjach. Pozwala zespołom IT i operacyjnym łatwo aprowizować (dodawać), cofać aprowizację (dezaktywować) i aktualizować dane użytkowników w wielu aplikacjach jednocześnie.

Uwaga: aprowizacja SCIM jest dostępna tylko w planie Enterprise.

Jakie funkcje SCIM są obsługiwane?

monday.com obsługuje następujące funkcje SCIM:

• Aprowizowanie użytkowników
• Cofanie aprowizacji użytkowników
• Aprowizowanie zespołów
• Cofanie aprowizacji zespołów
• Zmiana nazw zespołów
• Aktualizowanie danych użytkowników
• Przypisywanie użytkowników do zespołów
• Usuwanie przypisania użytkowników do zespołów

Opcje konfiguracji SCIM

Istnieją trzy sposoby skonfigurowania aprowizacji SCIM na koncie monday.com:

1. Istniejące aplikacje SCIM monday.com
   Obecnie współpracujemy z trzema głównymi dostawcami: OKTA, Entra ID i OneLogin. Możesz też użyć własnego dostawcy (zobacz drugą opcję) albo zintegrować się bezpośrednio z naszym API SCIM (zobacz trzecią opcję).

Więcej informacji o włączaniu aprowizacji SCIM dla istniejących aplikacji monday.com znajdziesz poniżej:
Aprowizacja SCIM za pomocą OKTA
Aprowizacja SCIM za pomocą Entra ID
Aprowizacja SCIM za pomocą OneLogin 2. Niestandardowa integracja SCIM z dostawcami tożsamości
Więcej informacji o niestandardowej integracji SCIM znajdziesz w tym artykule. 3. API SCIM
Ta metoda została opisana w dalszej części artykułu. Czytaj dalej, aby dowiedzieć się więcej o konfigurowaniu aprowizacji SCIM za pomocą API.

API SCIM

Nasza implementacja SCIM jest zgodna z wersją 2.0 protokołu.

Podstawowy adres URL dla wszystkich wywołań z dostawcy tożsamości do monday.com to: https://<YOUR_DOMAIN>.monday.com/scim/v2/. Wszystkie metody SCIM korzystają z tego adresu bazowego.

Uwaga: Zastąp nazwą adresu URL swojego konta (jeśli adres URL Twojego konta to myaccount.monday.com, wpisz tutaj „myaccount”).

Token Bearer

Do każdego żądania SCIM należy dołączyć token Bearer OAuth. Aby wygenerować taki token, otwórz sekcję administratora na swoim koncie. Następnie przejdź do karty „Zabezpieczenia” (Security), otwórz sekcję SCIM, kliknij przycisk „Generuj” (Generate) i skopiuj wygenerowany token.

Podczas wywoływania dowolnej metody SCIM token należy przekazać w nagłówku Authorization z typem Bearer.

Przykład użycia tokenu Bearer:

GET /scim/v2/Users  
Host: company.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIi2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt94Ux83XXXXXXXX

Uwaga: W żądaniach zawierających dane, np. PATCH, PUT i UPDATE, dodaj nagłówek Content-Type o wartości application/json.

Punkty końcowe SCIM

Atrybuty użytkownika

Atrybuty to zestaw informacji o użytkowniku i jego stanie. Czasami kilka atrybutów SCIM jest mapowanych na jedno pole profilu monday.com. Na przykład pole „Name” w monday.com może być uzupełniane na podstawie atrybutu SCIM „displayName” lub atrybutów „name”.

Poniższa tabela zawiera wszystkie atrybuty użytkownika obsługiwane przez API SCIM monday.com:

Atrybut monday.com	Atrybuty API SCIM	Opis	Przykładowa wartość
Name (wymagane)	name, displayName	Wyświetlana nazwa użytkownika.	"name": { "givenName": "Test", "familyName": "User" } "displayName": "Test User"
Email Address (wymagane)	userName, email	Adres e-mail używany przez użytkownika do logowania się do monday.com.	"userName": "employee@company.com" "emails": [{ "type": "work", "primary": true, "value": "employee@company.com" }]
Active (wymagane)	active	Podczas tworzenia użytkownika to pole musi mieć wartość „true”. Zmiana wartości „active” użytkownika na „false” spowoduje jego dezaktywację w monday.com.	"active": true
Position	title	Stanowisko użytkownika w firmie.	"title": "Senior IT Engineer"
Timezone	timezone	Strefa czasowa użytkownika. Wszystkie daty na platformie będą zgodne z tą strefą czasową. Akceptowane są formaty „Europe/Berlin” i „Berlin”.	"timezone": "Pacific Time (US & Canada)"
Locale	locale	monday.com wyświetla zlokalizowaną wersję dla różnych ustawień regionalnych.	"locale": "fr"
Phone Number	phoneNumbers	Numery telefonu użytkownika. Uwaga: wyświetlany będzie tylko jeden numer - oznaczony jako „primary” albo, jeśli żaden nie jest tak oznaczony, pierwszy numer na liście.	"phoneNumbers": [{ "value": "+972523090049", "type": "work", "primary": true }]
Home Address	addresses	Adres użytkownika. Wyświetlany będzie tylko jeden adres - oznaczony jako „primary” albo, jeśli żaden nie jest tak oznaczony, pierwszy adres na liście. Uwaga: ten atrybut nie jest obsługiwany w operacji PATCH /Users/{id}.	"addresses": [{ "value": "21B Baker St., London", "type": "work", "primary": true }]
User Type	userType	Poziom uprawnień użytkownika na koncie (więcej informacji znajdziesz tutaj). Dostępne wartości to między innymi: admin, member, viewer, guest, identyfikator roli niestandardowej lub portal_user (użytkownik portalu monday service).	"userType": "admin"
Department	department	Dział użytkownika. Uwaga: użytkownik może należeć tylko do jednego działu naraz.	POST / PUT - opcja 1 { "department": "Sales" } POST / PUT - opcja 2 { "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": { "department": "Sales" } } Żądanie PATCH - operacja ADD { "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations": [{ "op": "add", "path": "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department", "value": "Sales" }] } Żądanie PATCH - operacja REPLACE { "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations": [{ "op": "replace", "path": "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department", "value": "Sales" }] }
Niestandardowe atrybuty użytkownika Mogą zawierać dowolny ciąg znaków	Mogą zawierać dowolny ciąg znaków	Niestandardowe atrybuty użytkownika, które można wykorzystywać w funkcjach monday w miarę ich udostępniania	{ "urn:ietf:params:scim:schemas:extension:monday:2.0:User": { "custom_attribute_1": "custom value 1", "custom_attribute_2": "custom value 2" } }

Gdy wartość działu jest przesyłana dla użytkownika za pomocą SCIM, system działa w następujący sposób:

• Użytkownicy, którzy nie należą do żadnego działu, zostaną do niego przypisani.
• Jeśli dział nie istnieje na koncie, zostanie utworzony.
• Użytkownicy, którzy już należą do tego działu, nie zostaną objęci zmianami.
• Użytkownicy przypisani do innego działu na koncie zostaną przeniesieni do działu wskazanego przez SCIM i usunięci z poprzedniego.
• Po przypisaniu użytkownika do działu obok nazwy działu pojawi się oznaczenie SCIM.
• Działami nie można zarządzać za pomocą SCIM. Nie można utworzyć pustego działu, zmienić jego nazwy ani go usunąć.

Aby skonfigurować aprowizację SCIM obsługującą role niestandardowe jako typy użytkowników:

1. Skonfiguruj odpowiednią rolę niestandardową w monday.com zgodnie z instrukcjami w tym artykule.
2. Skopiuj identyfikator roli niestandardowej. Możesz to zrobić w centrum uprawnień konta: kliknij menu z trzema kropkami obok nazwy roli, a następnie wybierz „Kopiuj identyfikator” (Copy ID), jak pokazano poniżej.
3. Ustawiając userType, przekaż identyfikator roli niestandardowej jako „ciąg znaków” (tak samo jak wartość admin, viewer, member lub guest).

Uwaga: Wszystkie punkty końcowe wymagają, aby użytkownik został aprowizowany. Jeśli w odpowiedzi na żądanie otrzymasz 404 Not Found, najpierw wyślij żądanie POST dla tego użytkownika, aby go aprowizować.

Punkty końcowe użytkowników

GET /Users

Zwraca stronicowaną listę użytkowników. Domyślna wartość itemsPerPage to 50. Możesz wyszukiwać użytkowników za pomocą filtra, ale tylko według adresu e-mail i wyłącznie z użyciem operatora eq. Aby wyszukiwać według adresu e-mail, przekaż go jako userName.

Poniżej znajdziesz przykład żądania zwracającego stronicowaną listę użytkowników:

GET /scim/v2/Users?filter=userName eq employee@company.com&count=51&startIndex=4  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX

Uwaga: startIndex zaczyna się od 1. Oznacza to, że pierwszy użytkownik ma numer 1, a nie 0.

Domyślnie punkt końcowy GET /Users zwraca tylko użytkowników, którzy zostali już aprowizowani przez SCIM na Twoim koncie. Aby pobrać wszystkich użytkowników, także tych, którzy nie zostali jeszcze aprowizowani, dodaj do zapytania poniższy parametr:

GET /scim/v2/Users?scim_provisioned_only=false

Aby pobrać nieaktywnych użytkowników, dodaj do zapytania poniższy parametr:

GET /scim/v2/Users?include_inactive=true

GET /Users/{id}

Pobiera konkretnego użytkownika o podanym identyfikatorze SCIM. Aby znaleźć identyfikator SCIM użytkownika, wyślij żądanie GET z filtrem dla jego userName.

Przykład:

GET /scim/v2/Users/80d60b37-3c75-4e41-9bb0-ae6588b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX

POST /Users

To żądanie tworzy użytkownika w monday.com. Musi zawierać adres e-mail w polu emails lub userName, a także pole active ustawione na true. Wszystkie pozostałe pola są opcjonalne.

Jeśli użytkownik o podanym adresie e-mail już istnieje w monday.com:

1. Jeśli użytkownik jest dezaktywowany, zostanie aktywowany.
2. Jeśli użytkownik jest aktywny, ale nie był wcześniej aprowizowany, zostanie aprowizowany (otrzyma scim_uid i będzie zwracany podczas pobierania listy wszystkich użytkowników).

W przeciwnym razie zwrócona zostanie odpowiedź 419 Conflict. Na poprawne żądania zwracana jest odpowiedź 201 Created.

Przykład:

POST /scim/v2/Users  
Host: company.monday.com  
Accept: application/json  
Content-Type: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX  


{  
   "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],  
   "userName": "employee@company.com",  
   "name": {  
       "givenName": "Test",  
       "familyName": "User"  
   },  
   "emails": [{  
       "primary": true,  
       "value": "employee@company.com",  
       "type": "work"  
   }],  
   "displayName": "Test User",  
   "locale": "es",  
   "timezone": "Europe/Brussels",  
   "title": "Full-Stack Engineer",  
   "addresses": [{  
       "type": "work",  
       "primary": true,  
       "value": "21B Baker St., London"  
   }],  
   "externalId": "00ujl29u0le5T6Aj10h7",  
   "active": true  
}

PATCH /Users/{id}

Żądanie PATCH pozwala zaktualizować atrybuty konkretnego użytkownika. Atrybuty, których nie wymieniono w żądaniu, pozostaną bez zmian.

Przykład:

PATCH /scim/v2/Users/80d60b37-3c75-4e41-9bb0-ae6588b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Content-Type: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX  


{  
   "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],  
   "Operations": [{  
       "op": "replace",  
       "value": {  
           "active": false  
       }  
   }]  
}

PUT /Users/{id}

Żądanie PUT całkowicie aktualizuje użytkownika. Przydaje się do całkowitego zastąpienia zasobu użytkownika.

Uwaga: atrybutów active i userType nie można zmieniać za pomocą żądania PUT. Do ich zmiany użyj wyłącznie PATCH.

Przykład:

PUT /scim/v2/Users/80d60b37-3c75-4e41-9bb0-ae6588b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Content-Type: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX  


{  
   "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],  
   "name": {  
       "givenName": "Test",  
       "familyName": "User"  
   },  
   "emails": [{  
       "primary": true,  
       "value": "employee@company.com",  
       "type": "work"  
   }],  
   "locale": "es",  
   "timezone": "Europe/Brussels",  
   "title": "Senior Full-Stack Engineer",  
   "addresses": [{  
       "type": "work",  
       "primary": true,  
       "value": "21B Baker St., London"  
   }]  
}

DELETE /Users/{id}

Żądanie DELETE dezaktywuje użytkownika. Nie usuwa go trwale - tę czynność można cofnąć (miękkie usunięcie). Działa tak samo jak żądanie PATCH z wartością „active”: false. Na poprawne żądanie DELETE zwracana jest odpowiedź 204 No Content.

Przykład:

DELETE /scim/v2/Users/80d60b37-3c75-4e41-9bb0-ae6588b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer   
yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX

Punkty końcowe grup

Grupy SCIM odpowiadają zespołom monday.com. Możesz tworzyć i usuwać zespoły, zmieniać ich nazwy oraz przypisywać użytkowników do zespołów i usuwać ich przypisania. Pamiętaj, że przypisywanie i usuwanie przypisań jest dostępne tylko za pomocą metody HTTP PATCH.

Ze względów związanych z prywatnością zalecamy uzgodnienie aprowizacji zespołów z administratorem monday.com. Dzięki temu użytkownicy nie utracą dostępu do swoich danych ani nie uzyskają do nich dostępu przez pomyłkę.

Uwaga: jeśli przypiszesz grupę do aplikacji monday.com u swojego dostawcy tożsamości, a w monday.com istnieje już zespół o tej samej nazwie, grupa dostawcy tożsamości go zastąpi.

Atrybuty grup

Grupy mają atrybut displayName, który określa nazwę grupy wyświetlaną na stronie Zespoły, oraz atrybut members - listę aprovisionowanych użytkowników przypisanych do grupy.

Poniższa tabela zawiera wszystkie atrybuty zespołów obsługiwane przez API SCIM monday.com:

Atrybut monday.com	Atrybuty API SCIM	Opis	Przykładowa wartość
Name (wymagane)	displayName	Wyświetlana nazwa zespołu	"displayName": "R&D Department"
Użytkownicy	members	Lista użytkowników przypisanych do zespołu	"members": [{ "value": "80d60b37-3c75-4e41-9bb0-ae688b6448d", "$ref": "http://monday.lvh.me/scim/v2/Users/80d60b37-3c75-4e41-9bb0-ae688b6448d", "display": "Ben Frank", "type": "User" }]

GET /Groups

Zwraca stronicowaną listę zespołów. Domyślna liczba elementów na stronie (itemPerPage) wynosi 50. Możesz wyszukiwać zespoły za pomocą filtra, ale tylko według displayName i wyłącznie z użyciem operatora eq.

Uwaga: startIndex zaczyna się od 1. Oznacza to, że pierwszy zespół ma numer 1, a nie 0.

Poniżej znajduje się przykład żądania zwracającego stronicowaną listę grup:

GET /scim/v2/Groups?filter=displayName eq "Developers"  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX

GET /Groups/{id}

Pobiera konkretny zespół o podanym identyfikatorze SCIM. Aby znaleźć identyfikator SCIM zespołu, wyślij żądanie GET z filtrem dla jego displayName.

Przykład:

GET /scim/v2/Groups/80d60b37-3c75-4e41-9bb0-ae6588b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowC4wMDBaIiwicGVIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX

POST /Groups

Tworzy nowy zespół. Żądanie musi zawierać atrybut displayName.

Przykład:

POST /scim/v2/Groups  
Host: company.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX  
{  
   "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],  
   "displayName": "Chess Players",  
   "members": []  
}

PATCH /Groups/{id}

Ta metoda przypisuje użytkowników do zespołu, usuwa ich przypisania lub zmienia nazwę zespołu.

• Przypisywanie użytkowników

Aby przypisać użytkowników, wyślij operację „Add”, której wartością będzie identyfikator SCIM użytkownika, którego chcesz dodać.

Przykład przypisania do zespołu:

PATCH /scim/v2/Groups/80d60b37-3c75-4e41-9bb0-a6588b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX  
{  
   "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],  
   "Operations": [{  
       "op": "Add",  
       "path": "members",  
       "value": [{  
           "value": "711f99b8-d6d1-41ad-860e-4896b7e8b3d6"  
       }]  
   }]  
}

• Usuwanie przypisania użytkowników

Aby usunąć przypisanie użytkowników, wyślij operację „Remove”, której wartością będzie ścieżka do identyfikatora SCIM użytkownika, którego chcesz usunąć z zespołu.

Przykład usunięcia przypisania do zespołu:

PATCH /scim/v2/Groups/80d60b37-3c75-4e41-9bb0-ae688b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX  
{  
   "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],  
   "Operations": [{  
       "op": "remove",  
       "path": "members[value eq '711f99b8-d6d1-41ad-860e-4896b7e8b3d6']"  
   }]  
}

• Zmiana nazwy zespołu

Aby zmienić nazwę zespołu, wyślij operację „Replace” z nową nazwą jako wartością i bez ścieżki.

Przykład zmiany nazwy zespołu:

PATCH /scim/v2/Groups/80d60b37-3c75-4e41-9bb0-ae588b6448d
Host: <YOUR_DOMAIN>.monday.com
Accept: application/json
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX
{
   "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
   "Operations": [{
       "op": "replace",
       "path": "displayName",
       "value": "The Avengers"
   }]
}

DELETE /Groups/{id}

Ta metoda trwale usuwa zespół w monday.com. Pamiętaj, że przypisani do niego członkowie nie są usuwani - usuwany jest tylko zespół. Po pomyślnym żądaniu zwracana jest odpowiedź 204 No Content.

Przykład usunięcia grupy:

DELETE /scim/v2/Groups/80d60b37-3c75-4e41-9bb0-ae6588b6448d  
Host: <YOUR_DOMAIN>.monday.com  
Accept: application/json  
Authorization: Bearer yJhbGc4iOiJIUzI1NiJ9.eyJ0aXXXXXXXXUxNTEsInVpZCI6MSwiaWLkIjoiMjAyMC0XXXXXXMjoxNDowMC4wMDBaIiwicGVyIjoic2NpbTphbGwifQ.J8EXXXXXXXltQZA6PAt9i2F4Ux83XXXXXXXX

Uwaga: Aby skonfigurować podzespół za pomocą SCIM, musisz ręcznie ustawić hierarchię zespołów na koncie monday.com. Aprowizacja SCIM nie może bezpośrednio tworzyć hierarchii zespołów ani nią zarządzać. Hierarchia zespołów skonfigurowana na koncie pozostanie jednak bez zmian, nawet jeśli zespół lub podzespół zostanie aprowizowany przez SCIM.

Obsługa błędów

Poniższa tabela zawiera kody błędów i możliwe przyczyny ich wystąpienia. Wskazówki dotyczące rozwiązania problemu znajdziesz w trzeciej kolumnie:

Kod błędu	Co oznacza?	Co możesz zrobić?
404 Not Found	Zasób może być wyłączony lub nieaprovisionowany.	Najpierw spróbuj aprowizować zasób za pomocą żądania POST.
409 Conflict	Użytkownik z podanym adresem e-mail już istnieje i został aprowizowany.	Najpierw spróbuj pobrać użytkownika za pomocą GET - być może to właśnie jego szukasz.
403 Forbidden	Próbujesz uzyskać dostęp do danych, do których nie masz uprawnień.	Upewnij się, że używany adres URL jest prawidłowy i że token został przekazany we właściwy sposób. Ten błąd może też oznaczać, że nie masz konta Enterprise, które jest wymagane do korzystania z punktów końcowych SCIM.
500 Internal Server Error	Wystąpił błąd po naszej stronie.	Upewnij się, że przekazane dane są prawidłowe. Jeśli tak, wyślij zgłoszenie do działu obsługi klienta - pomożemy Ci rozwiązać problem.
400 Bad Request	Wysłano żądanie dotyczące czynności, której nie możemy wykonać.	Upewnij się, że przekazane dane są prawidłowe. Jeśli nie wiesz, które dane są nieprawidłowe, wyślij zgłoszenie do działu obsługi klienta - pomożemy Ci to ustalić.
429 Too Many Requests	Wysłano zbyt wiele żądań w krótkim czasie.	Zrób sobie chwilę przerwy i napij się mrożonej herbaty. Gdy upłynie limit czasu, będziemy znów obsługiwać Twoje żądania. Limit żądań zapisujących: maksymalnie 450 na minutę na konto. Żądania zapisujące obejmują: tworzenie, modyfikowanie, pełne aktualizowanie i usuwanie użytkowników oraz tworzenie, modyfikowanie i usuwanie grup. Limit żądań odczytujących: maksymalnie 1000 na minutę na konto. Żądania odczytujące obejmują: pobieranie listy użytkowników, szczegółów użytkownika, listy grup i szczegółów grup.
501 Not Implemented	Żądana funkcja nie jest jeszcze obsługiwana.	Możesz spróbować wysłać prostsze żądanie albo utworzyć zgłoszenie do działu obsługi klienta. Dodamy obsługę Twojego przypadku użycia.

Pamiętaj: dostawca tożsamości jest źródłem prawdy

Po połączeniu konta monday.com z SCIM każda zmiana danych wprowadzona na platformie monday.com zostanie zastąpiona danymi przesłanymi przez SCIM. Na przykład użytkownik zostaje aprowizowany i przypisany do zespołu, a następnie ręcznie usuwasz go z tego zespołu na platformie monday.com. Przy kolejnym uruchomieniu aprowizacji SCIM użytkownik zostanie ponownie przypisany do zespołu.

Często zadawane pytania

Jak administrator może wygenerować nowy token SCIM?

Aby wygenerować nowy token SCIM, otwórz sekcję administratora na swoim koncie. Następnie przejdź do karty „Zabezpieczenia” (Security), otwórz sekcję SCIM, kliknij przycisk „Generuj” (Generate) i skopiuj wygenerowany token.

Po wprowadzeniu tokenu u dostawcy tożsamości konfiguracja będzie gotowa.

Co się stanie, jeśli zmienię swoje dane osobowe na koncie monday.com?

Synchronizacja z dostawcą tożsamości działa jednokierunkowo. Wszelkie zmiany wprowadzone w profilu użytkownika lub na stronie zespołów w monday.com zostaną zastąpione przy następnej synchronizacji konta z dostawcą tożsamości.

Co to oznacza?

• Aby zmienić atrybuty profilu użytkownika, musisz zaktualizować je u dostawcy tożsamości.
• Aby dodawać użytkowników do zespołów utworzonych przez dostawcę tożsamości lub usuwać ich z tych zespołów, musisz wprowadzać zmiany u dostawcy tożsamości.
• Jeśli utworzysz w monday.com zespół, który nie jest grupą u dostawcy tożsamości, grupy u dostawcy tożsamości nie będą miały na niego wpływu.

Co się stanie, jeśli dodam użytkowników do zespołu na koncie monday.com?

Jeśli zespół jest aprowizowany przez dostawcę tożsamości, dodani użytkownicy zostaną w końcu usunięci z zespołu, a ich miejsce zajmą użytkownicy aprowizowani do odpowiadającej mu grupy u dostawcy tożsamości. Jeśli zespół nie jest aprowizowany przez dostawcę tożsamości, dodani do niego użytkownicy pozostaną w zespole.

Dlaczego nie mogę dezaktywować administratora, który wygenerował token SCIM, ani zmienić jego typu użytkownika?

Jeśli administrator na Twoim koncie wygenerował wcześniej token SCIM, nie można dezaktywować jego konta ani zmienić jego typu użytkownika z administratora na osobę bez uprawnień administratora. To ograniczenie zapobiega problemom z aprowizacją SCIM na Twoim koncie. Informacje o tym, jak obejść to ograniczenie, znajdziesz w tym artykule.

Co stanie się z użytkownikami już istniejącymi na moim koncie po włączeniu aprowizacji SCIM?

Istniejący użytkownicy na koncie monday.com zostaną objęci następującymi zmianami:

• Użytkownicy, których adres e-mail istnieje zarówno na koncie monday.com, jak i u dostawcy tożsamości, będą zarządzani przez dostawcę tożsamości. Ich dane zostaną zaktualizowane zgodnie z konfiguracją u dostawcy (atrybuty, zespoły, rola itp.).
• Użytkownicy, którzy istnieją na koncie, ale nie u dostawcy tożsamości, nie zostaną objęci zmianami. Dostawca tożsamości nie będzie nimi zarządzać, dopóki nie zostaną do niego dodani.
• Użytkownicy, którzy istnieją u dostawcy tożsamości, ale nie na koncie monday.com, zostaną aprowizowani i dodani do konta monday.com.

Co się stanie, jeśli użytkownik należy u dostawcy tożsamości do kilku grup przypisujących różne role monday.com?

Jeśli użytkownik należy do kilku grup przypisujących różne role - na przykład do grupy zawierającej osoby przeglądające i grupy zawierającej członków zespołu - użytkownik otrzyma wyższą rolę monday.com. Hierarchia ról wygląda następująco: Admin > Member > Viewer > Guest.

Co się stanie, jeśli użytkownikowi przypisano kilka ról niestandardowych?

Jeśli użytkownikowi przypisano kilka ról niestandardowych, otrzyma ostatnią rolę niestandardową przekazaną przez dostawcę tożsamości, zgodnie z hierarchią ról bazowych (Admin > Member > Viewer > Guest).

Jakie wiadomości e-mail otrzymują nowi użytkownicy aprowizowani przez SCIM?

Nowi użytkownicy utworzeni za pomocą aprowizacji SCIM otrzymują wiadomość e-mail „Witamy w monday” około godziny po utworzeniu konta. Nie otrzymują wiadomości z zaproszeniem.