Verwenden Sie SCIM 2.0 mit Showpad

SCIM ist ein allgemein anerkannter offener Standard, der die Verwaltung von Benutzeridentitäten in Cloud-basierten Anwendungen und Dienstleistungen vereinfacht. Es gibt eine Reihe von Standardverträgen für Benutzer und Gruppen, die erweitert werden können.

Unsere SCIM-Implementierung zielt auf die Version 2.0 des Protokolls ab.
Nützliche Links:

• SCIM offener Standard
• SCIM 2.0-Spezifikation

Dieser Artikel behandelt die SCIM-Implementierung in Showpad.

Zugriff auf SCIM

Die SCIM-Implementierung sollte als Erweiterung der öffentlichen API von Showpad betrachtet werden. Der Zugriff kann über die Inhaberauthentifizierung erfolgen.

Sie benötigen dies, um erfolgreich zu sein

• Showpad Unternehmenspaket
• Showpad- Administratorkonto
• Ein Identitätsmanagementsystem eines Drittanbieters 

Die Konzepte der Großartigkeit

• Endpunkte
• Grundlegende Befehle
• SCIM 2.0-Methoden
• Gruppenbefehle

Endpunkte

Der Basisendpunkt für die API ist:

https: // {Organisations-Subdomain}.showpad.biz/api/users/scim/v2

Jeder folgenden Anforderung muss der Basisendpunkt vorangestellt werden.

Grundlegende Befehle

GET / Schemas

Gibt Konfigurationsdetails aus.
Sie können sie auch separat abrufen:

• GET /Schemas/urn:ietf:params:scim:schemas:core:2.0:Benutzer
• GET /Schemas/urn:ietf:params:scim:schemas:core:2.0:Group
• GET /Schemas/urn:ietf:params:scim:schemas:extension:enterprise:2.0:nutzer

GET / ResourceTypes

Gibt Arten von Ressourcen aus.
Sie können sie auch separat abrufen:

• GET / ResourceTypes/Benutzer
• GET / ResourceTypes /Gruppe

GET / ServiceProviderConfig

Gibt eine Liste der Vorgänge zurück, die in der aktuellen Implementierung unterstützt werden

Nutzer

Der BeNutzer ordnet SCIM-Attribute einem Showpad- Benutzer zu. Sie können Benutzer auflisten, filtern, hinzufügen, bearbeiten oder entfernen.

Attribute

Attribute wie Telefonnummern, E- Mails und Rollensind in SCIM mehrwertig, in Showpad jedoch einzigartig. Wenn Sie den Benutzer erstellen oder ersetzen und mehrere Werte angeben, wird der Primärwert zugeordnet und die anderen Werte verworfen. Wenn es keine Primärdaten gibt, wird der erste Wert verwendet.

Gruppen ist ein schreibgeschütztes Attribut. Auf diese Weise können Sie sehen, zu welchen Benutzergruppen ein Benutzer gehört. Das Ändern der Mitgliedschaft eines Benutzers in einer Gruppe sollte über die Benutzergruppe- Ressource erfolgen.

Unternehmen in der Tabelle entspricht dem Unternehmensschema urn : ietf: params: scim: Schemas: Erweiterung: Unternehmen: 2.0:Benutzer

E-Mails [0].Wert- und Benutzernamenattribute müssen im System eindeutig sein. Andernfalls wird ein Eindeutigkeitsfehler angezeigt.

E-Mails [0].Der Wert sollte dem E-Mail-Muster folgen.

Ein neuer Benutzer wird der Gruppe "Alle Benutzer" automatisch zugewiesen. Dies ist eine Standardgruppe, die Sie dem Benutzer nicht zuweisen können. Wenn Sie den Benutzer einer anderen Gruppe zuweisen möchten, sollte diese bereits vorhanden sein oder über den Gruppenendpunkt erstellt werden.

Beim Rollenwechsel [0].Beachten Sie, dass nur bestimmte Rollen im System unterstützt werden:

• Besitzer (siehe Hinweis) 
• Admin
• Manager
• Tablet, eine Standardrolle

Hinweis: Im System ist nur 1 Eigentümer zulässig. Sie werden einen Eindeutigkeitsfehler erhalten , wenn Sie versuchen, einen anderen zu erstellen.

Berechtigungen

 Wenn ein Benutzer die Managerrolle hat, können Gruppen, für die er die Benutzer coachen kann, ihm zugewiesen werden. Das Zuweisen dieser Gruppen kann über den Abschnitt Berechtigungen erfolgen, indem Folgendes verwendet wird:

"Berechtigungen": [
 {
 "Wert": "22b3d7f8eea74c37d3d140642ccbaeba",
 "Typ": "Trainer_für_Gruppe"
 }
]

SCIM 2.0-Methoden

BEITRAG / Benutzer

Dieser Befehl erstellt einen Benutzer. 

POST {{url}} / Benutzer
Akzeptieren: application /JSON
Autorisierung: Inhaber {{token}}
Host: {{host}}

{
  "activ": wahr
,   "E-Mail": [
 {
 "primär": wahr
      , 
"Typ": "Arbeit      
", "Wert": "john.doe@showpad.com    "
  }
  ]
,   "locale": "en
 ", "name": {
 "Familienname": "Doe
 ", "Vorname": "John
  "
}    , 
        "Berechtigungen": [
        {
    "Wert": "22b3d7f8eea74c37d3d140642ccbaeba
  ", "Typ": "Trainer_für_Gruppe" 
  "
}    
]      ," Rollen ": [
 {
 " Wert ":"Manager
  "
}  
]    ,
    " Zeitzone ":" Europa / Brüssel
  "," Schemata 
": [" Urne: ietf: params: scim: Schemas: Kern: 2.0:Benutzer  
    "," Urne: ietf: params: scim: Schemas: Erweiterung: Unternehmen: 2.0:Benutzer"
  ]
,  " Urne: ietf: Parameter: scim: Schemas: Erweiterung: Unternehmen: 2.0:Benutzer": {
" Organisation ":" John Does org "
   }  ,  " Benutzername":"john.doe@showpad.com"   } 

Get /Users/{Id} (Suche nach/ Benutzer / {Id})

Dieser Befehl gibt einen Benutzer mit der angegebenen ID zurück.

GET {{url}}/Users/{id}
Accept: application / JSON
Autorisierung: Inhaber {{token}}
- Host:{{host}}

GET {{url}} / Users? StartIndex = 11 & count = 10 &filter;=username%20eq%20%22john.doe@showpad.com% 22
Akzeptieren: application / JSON
Autorisierung: Bearer {{token}}
Host: {{host}}

PUT {{url}} / Benutzer / {id}
Akzeptieren: Antrag / JSON
Autorisierung: Inhaber {{token}}
Host :{{host}}

{
  ,,E-
Mails": [    
{      
"Wert": "john.doe.second@showpad.com"    
}  
],,  , 
    Name": {
,,Familienname    ":,,Doe Zweiter",
  ,, Vorname
":,, John "  
},,
  Benutzername ":,,john-doe-second "   } 

Löschen {{url}} / Benutzer / {id}
Akzeptieren: Antrag / JSON
Autorisierung: Inhaber {{token}}
Host: {{host}}

POST {{url}} / Gruppen
Akzeptieren: application / JSON
Autorisierung: Inhaber {{token}}
Host: {{host}}

{
  "Schemas": ["urn: ietf: params: scim: schemas: core: 2.0: Gruppe"],
  "Anzeigename": "SCIM Testgruppe",
  "Mitglieder": [
    {
      "Wert": "abcdefgh123456789"
    },
    {
      "Wert": "123456789abcdefgh"
    }
  ]
}

GET {{url}} / Groups / {id}
Akzeptieren: application / JSON
Autorisierung: Bearer {{token}}
Host: {{host}}

GET {{url}} / Groups? StartIndex = 11 & count = 10 "
Akzeptieren: application / JSON
Autorisierung: Bearer {{token}}
Host: {{host}}

PUT {{url}}/Groups/{id}
Akzeptieren: application/JSON
Authorization: Bearer {{token}}
Host: {{host}}

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Gruppe"],
  "Anzeigename": "SCIM-Testgruppenänderung",
  "Mitglieder": [
    {
      "Wert": "abcdefgh123456789"
    },
    {
      "Wert": "123456789abcdefgh"
    }
  ]

LÖSCHEN {{url}} /Gruppen /{id}
Akzeptieren: application/JSON
Authorisierung: Bearer {{token}}
Host: {{host}}