Le Guide Développeur de l'Auto-Provisionnement SCIM

Facilitez l’adoption de votre application grâce au provisionnement et au déprovisionnement automatique des utilisateurs en temps réel. Synchronisez votre solution avec l’annuaire utilisateur de votre client par de simples Webhooks. Les administrateurs informatiques doivent gérer le cycle de vie des accès des employés aux applications tierces, selon leurs entrées et sorties de l’organisation. Ils utilisent pour cela des outils de gestion des accès et identités d’entreprise (Identity and Access Management, ou IAM), telles que Microsoft Entra ID, Okta ou Google Workspace, pour gérer l’accès de leurs utilisateurs aux logiciels tiers. Les annuaires permettent aux administrateurs informatiques d’activer et de désactiver des comptes et de créer des groupes qui définissent les règles d’accès. Avec Cryptr, vous recevrez dans votre application une « photographie avant/après » des changements des données à chaque évolution des utilisateurs et des groupes au sein de la solution IAM de l’organisation.

• Quickstart
• 15 min

Dans ce guide, nous vous accompagnerons depuis l’activation de votre Directory Sync sur une Organization jusqu’au provisionnement de votre premier utilisateur dans votre propre application.

Avant de commencer

Créez votre compte Cryptr gratuitement maintenant, vous aurez ainsi l’élément requis pour suivre ce guide :

• Organization : Vous créerez votre première organisation, qui représente par exemple votre client (ou vous-même pour un premier test). En savoir plus sur l’organisation.

1. Activer votre 1er Directory Sync

Pour activer la synchronisation Cryptr entre vous et le fournisseur d’identité (IdP) de votre client, vous devez activer le « Directory Sync » sur l’organisation que vous souhaitez synchroniser. Vous pouvez sélectionner l’Organisation via la barre de navigation latérale bleue à gauche de votre écran.

Afin de lancer le processus de configuration du Directory Sync, cliquez sur le bouton TRY FOR FREE du Directory Sync situé en haut à droite de votre écran. Une fois activé, la section Directory Sync du portail de configuration administrateur sera disponible pour l’administrateur de cette Organization. L’administrateur est le contact désigné au sein de l’entreprise cliente responsable de la gestion des identités et des accès (comme Microsoft, Okta ou Google).

2. Créer son webhook

Créer un point d’API pour recevoir les données

Vous devez créer un point d’API (par exemple /directory-sync), dans votre application, qui écoutera les requêtes API HTTP POST de Cryptr. Il servira de récepteur pour vos données d’utilisateurs provisionnés.

Javascript

// This example uses Express to receive webhooks
const express = require('express');
const app = express();

// Match the raw body to content type application/json
// If you are using Express v4 - v4.16 you need to use body-parser, not express, to retrieve the request body
app.post('/directory-sync', express.json({type: 'application/json'}), (request, response) => {
  const event = request.body;

  // Handle the event here
   console.log(event)

  // Return a response to acknowledge receipt of the event
  response.json({received: true});
});

app.listen(8000, () => console.log('Running on port 8000'));

PHP

$payload = @file_get_contents('php://input');
  $event = null;

  try {
      // Handle the event here
      $event = json_decode($payload, true);
  } catch(\UnexpectedValueException $e) {
      // Invalid payload
      http_response_code(400);
      exit();
  }

  http_response_code(200);

Python

import json
from django.http import HttpResponse

# Using Django
@csrf_exempt
def my_webhook_view(request):
  payload = request.body
  event = None

  try:
    # Manage event here
    event = json.loads(payload)
  except ValueError as e:
    # Invalid payload
    return HttpResponse(status=400)

  return HttpResponse(status=200)

Ruby

require 'sinatra'
require 'json'

post '/directory-sync' do
  # Handle the event here
  puts request.body.read
end

Créer un webhook depuis le tableau de bord

Cliquez sur le bouton « Webhooks » situé dans la barre de navigation à gauche de votre écran. Vous pourrez créer et tester un webhook en cliquant sur les boutons « New Webhook » et « Test Webhook ».

Nouveau webhook

Une fenêtre modale s’affichera pour vous guider dans la création de votre webhook.

Tester un webhook

Vous pouvez vérifier la bonne réception sur vos points d’API en déclenchant l’envoi d’un événement sur vos webhooks de sandbox. Une fenêtre modale s’affichera pour vous guider dans le test de vos webhooks.

3. Tester vous-même l’expérience de configuration

Tester avec un Okta gratuit

Si vous n’utilisez pas de gestionnaire d’identité, vous aurez besoin de créer un compte sur une solution de gestion des identités et des accès, comme celles que possèdent vos propres clients. Même si vous avez déjà un gestionnaire d’identité, nous vous recommandons de créer un compte Okta gratuit pour pouvoir tester le configurateur Directory Sync Cryptr. Okta est un leader du marché des Identity and Access Management (IAM).

Vous avez besoin d’une synchronisation SCIM (System for Cross-domain Identity Management) entièrement configurée sur un gestionnaire d’identité d’entreprise pour tester la synchronisation. Cela signifie que vous devez agir comme votre propre administrateur client et finaliser vous-même la configuration. C’est l’occasion de comprendre l’expérience que vont vivre vos clients. 😎

Ensuite, sur l’écran de l’Organization de test dans votre tableau de bord Cryptr, vous devez vous inviter avec votre propre adresse e-mail. Ceci permettra de vous enregistrer en tant qu’administrateur de cette Organisation pour réaliser la configuration Directory Sync dans votre compte de test Okta ou dans votre propre gestionnaire d’identité. Pour ce faire, il vous suffit de cliquer sur le bouton à côté du nombre d’administrateurs en haut de l’écran à droite du nom de l’Organisation.

Vous allez recevoir un lien d’accès par email. Il vous suffit de cliquer pour accéder à l’espace de configuration du Directory Sync de cette Organisation, cet espace est réservé aux administrateurs informatiques de vos clients qui pourront configurer le Directory Sync pour votre application en toute autonomie. Il permet à Cryptr l’échange des informations utiles entre Cryptr et la solution de Directory Sync de vos clients, telles que des identifiants, des clés, des fichiers de configuration et des certificats. Le configurateur Cryptr est un tutoriel interactif qui est régulièrement mis à jour.

À la fin de votre accompagnement, le configurateur vous invitera à valider votre paramétrage. Votre Directory Sync est parfaitement configuré, vous êtes prêt pour intégrer la synchronisation avec l’annuaire de cette Organization dans votre application.