Automatische gebruikersregistratie met aangepaste SCIM-profielen is een bètafunctie die alleen beschikbaar is voor een beperkt aantal deelnemers. Als u Automatische registratie niet ziet op de detailpagina van de app, is deze functie nog niet beschikbaar voor uw organisatie.
U kunt gebruikersaccounts automatisch instellen en beheren in een aangepaste of vooraf geïntegreerde SAML-app die SCIM 2.0 ondersteunt door automatische gebruikersregistratie te gebruiken met aangepaste SCIM-profielen.
Voordat u begint
Als u een aangepast SCIM-profiel wilt instellen, heeft u het volgende nodig:
- Een Cloud Identity-account met de rol van hoofdbeheerder. Ga naar Vooraf ingestelde beheerdersrollen voor meer informatie.
- Een aangepaste of vooraf geïntegreerde SAML-app die is ingesteld en aangezet voor gebruikers in de Beheerdersconsole.
Je app moet een SCIM-server hebben die:
- Ondersteunt SCIM-versie 2.0
- Gebruikt standaard HTTP-methoden, waaronder
POST,GET,PATCHmet fallback naarPUTenDELETE - Ondersteunt verificatie met dragertokens. Verificatie met OAuth-tokens wordt niet ondersteund.
Automatische gebruikersregistratie instellen met een aangepast SCIM-profiel
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Klik op de naam van de SAML-app.
- Klik onder Automatische registratie op Automatische registratie instellen.
- Voer de dragertoken van uw app in bij Toegangstoken en klik op Doorgaan.
- Voer de SCIM-eindpunt-URL van uw app in het veld Eindpunt-URL in en klik op Doorgaan. Google maakt verbinding met uw SCIM-eindpunt om ondersteunde kenmerken automatisch te ontdekken.
- Wijs uw Google-directorykenmerken toe aan de bijbehorende app-kenmerken. Als uw app schema-ontdekking ondersteunt, wordt de tabel vooraf ingevuld met ontdekte kenmerken. Als u aangepaste kenmerken handmatig wilt toewijzen, klikt u op Toewijzing toevoegen
Doorgaan als u klaar bent.
- (Optioneel) Als u geen groepen toevoegt, worden alle gebruikers met toegang tot de SAML-app geregistreerd. Zo beperkt u automatische registratie tot specifieke gebruikersgroepen:
- Typ bij Groepen zoeken een of meer letters van de groepsnaam, selecteer de groepsnaam en kies een bereik.
- Voeg eventuele extra groepen toe.
- (Optioneel) Als u een groep wilt verwijderen, klikt u op Verwijderen.
Als een groep gebruikers uit een secundair domein of van buiten uw organisatie bevat, worden deze gebruikers niet geregistreerd.
- Bepaal hoelang gebruikers toegang houden tot de app nadat de app voor ze is uitgezet of nadat hun Google Workspace-account is opgeschort of verwijderd. U kunt ervoor kiezen hun account op te schorten, permanent te verwijderen of op te schorten en daarna permanent te verwijderen. Je kunt het tijdsbestek voor de vertraging voor elke actie afzonderlijk instellen.
- Kies de gewenste opties voor elk van deze gebeurtenissen:
- Als een app wordt uitgezet voor een gebruiker
- Als een gebruiker wordt opgeschort in Google
- Als een gebruiker wordt verwijderd uit Google
Als u een gebruikersaccount opschort, wordt het gemarkeerd als gedeactiveerd. Als u het gebruikersaccount definitief verwijdert, wordt het permanent verwijderd uit de app. Stel altijd een langere tijdsduur in voordat het account van een gebruiker definitief wordt verwijderd. Ga naar Tijdsperioden voor uitschrijving bewerken voor meer informatie over opschorting en verwijdering.
- Klik op Doorgaan.
- Kies de gewenste opties voor elk van deze gebeurtenissen:
Test de verbinding:
- Zoek bij Google Directory-gebruiker een gebruiker die geen account heeft in uw app en selecteer deze.
Klik op Testen.
Google maakt een account voor de gebruiker in je app, updatet het en verwijdert het daarna. Bij elke bewerking staat Geslaagd, Mislukt of Niet uitgevoerd. Als een bewerking is mislukt, controleert u de HTTP-code, het SCIM-fouttype en de details van Onbewerkte reactie bekijken in uw app.
Opmerking: Als uw app geen
201 Createdretourneert voor de nieuwe gebruiker, bijvoorbeeld omdat de gebruiker al bestaat, mislukt Gebruiker maken en slaat Google de update- en verwijderbewerkingen over. Als Gebruiker verwijderen mislukt, verwijder je het testaccount handmatig in je app.
Klik op Voltooien.
Je kunt op Afronden klikken, zelfs als de test is mislukt, en later opnieuw testen. Met deze stap wordt de configuratie opgeslagen, maar wordt automatische registratie niet aangezet. Als u deze functie wilt aanzetten, gaat u naar de detailpagina van de appAutomatische registratie en zet u de schakelaar op Actief.
Opmerking: De instelling is uitgezet als uw app niet aanstaat voor gebruikers. Klik op User access (Gebruikerstoegang) en zet de app aan zodat u automatische registratie kunt aanzetten.
Registratiegegevens bewerken
Gebruikersgroepen bewerken waarop automatische registratie van toepassing is
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Klik op de naam van de SAML-app.
- Klik op Automatische registratie.
- Klik bij Provisioning scope (Registratiebereik) op Edit (Bewerken).
- Typ bij Search groups (Groepen zoeken) een of meer letters van de groepsnaam, selecteer de groepsnaam en kies een bereik.
- Voeg eventuele extra groepen toe.
- (Optioneel) Als u een groep wilt verwijderen, klikt u op Verwijderen.
Als een groep gebruikers uit een secundair domein of van buiten uw organisatie bevat, worden deze gebruikers niet geregistreerd. - Klik op Updaten.
Uitschrijfperioden bewerken
Ga als volgt te werk om te definiëren hoelang uitschrijfacties moeten worden uitgesteld voordat deze in werking treden:
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Klik op de naam van de SAML-app.
- Klik op Automatische registratie.
- Klik bij Uitschrijven op Bewerken.
- Selecteer voor elke gebeurtenis (Als een app wordt uitgezet voor een gebruiker, Als een gebruiker wordt opgeschort in Google en Als een gebruiker wordt verwijderd uit Google) de acties die moeten worden uitgevoerd en hoelang Google wacht nadat de wijziging is aangebracht voordat het verzoek naar uw app wordt gestuurd (Binnen 24 uur of Na 1, 7 of 21 dagen):
- Gebruikersaccount opschorten: Deactiveert de gebruiker in de app (
PATCHofPUTmetactive: false). - Gebruikersaccount definitief verwijderen: Verwijdert de gebruiker definitief uit de app (
DELETE /Users/{id}).
Als u beide opties selecteert, stelt u altijd een langere vertraging in voor definitief verwijderen dan voor opschorten. - Klik op Updaten.
Automatische registratie uitzetten en configuratiegegevens verwijderen
U kunt automatische registratie uitzetten voor de Canva-app zonder dat de configuratiegegevens verloren gaan. U kunt ook automatische registratie uitzetten en alle configuratiegegevens verwijderen.
Automatische registratie uitzetten
Zo zet u automatische registratie uit voor de app met behoud van de configuratiegegevens:
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Klik op de naam van de SAML-app.
- Kies een optie:
- Zet Automatische registratie uit.
- Klik op Automatische registratie
Status
Uitzetten.
- Klik op Uitzetten om te bevestigen.
Automatische registratie uitzetten en configuratiegegevens verwijderen
Zo zet u automatische registratie uit en verwijdert u alle configuratiegegevens:
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Klik op de naam van de SAML-app.
- Klik op Automatische registratie.
- Klik op Verwijderen om automatische registratie uit te zetten en alle configuratiegegevens te verwijderen.
Bestaande gebruikers worden niet verwijderd en kunnen de app nog steeds gebruiken.
Gebruiksinformatie controleren
- Nadat u automatische registratie heeft aangezet, kunt u de gebruiksgegevens beoordelen. Ga naar Automatische gebruikersregistratie controleren voor meer informatie.
- U kunt de volgende gebruiksgegevens van de afgelopen 30 dagen controleren:
| Gebeurtenis in het beheerderslogboek | Beschrijving |
|---|---|
| Gebruiker gemaakt via automatische registratie | Via automatische registratie gemaakte gebruikers |
| Automatisch geregistreerde gebruiker geüpdatet | Via automatische registratie geüpdatete gebruikers |
| Automatisch geregistreerde gebruiker opgeschort | Via automatische registratie opgeschorte gebruikers |
| Opschorting automatisch geregistreerde gebruiker opgeheven | Via automatische registratie opnieuw geactiveerde gebruikers |
| Automatisch geregistreerde gebruiker permanent verwijderd | Via automatische registratie verwijderde gebruikers |
| Mislukt | Mislukte verzoeken |
Als automatische registratie niet meer werkt
Automatische registratie werkt niet meer als Google geen verbinding meer kan maken met uw app. De dragertoken is bijvoorbeeld verlopen of ingetrokken, of de SCIM-URL van de app is gewijzigd. Update de token of URL om dit op te lossen:
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Klik op de naam van de SAML-app.
- Klik op Automatische registratie.
- Zo updatet u de dragertoken:
- Klik bij App-autorisatie op Opnieuw autoriseren.
- Plak bij Toegangstoken een nieuwe dragertoken uit de app.
- Klik op Opnieuw autoriseren.
- Als u de SCIM-basis-URL wilt updaten, klikt u bij Eindpunt-URL op Bewerken, voert u de nieuwe URL in en klikt u op Updaten.
- (Optioneel) Klik bij Verbinding testen op Testen om de verbinding te verifiëren.
Ga naar de documentatie van de app voor andere redenen waarom automatische registratie misschien niet meer werkt.