Différences

Ci-dessous, les différences entre deux révisions de la page.

--- systemes:1password:scim-bridge [10/06/2026 12:49] – bonnet
+++ systemes:1password:scim-bridge [11/06/2026 11:53] (Version actuelle) – bonnet
@@ Ligne 103: / Ligne 103: @@
 Docker Engine est maintenant installé et prêt à être utilisé.
-===== Pull de l'image Docker 1password/scim =====
+===== Configuration 1Password =====
-Télécharger l'image Docker de 1Password SCIM Bridge depuis Docker Hub.
-<code bash>
+==== Fichier de l'application ====
-sudo docker pull 1password/scim:v2.9.15
-</code>
+Créer un dossier 1password dans le répertoire /etc, rentrez dedans et créez un fichier docker-compose.yaml
-Vérifier que l'image a bien été téléchargée sur le système.
 <code bash>
-docker images
+mkdir /etc/1password
+cd /etc/1password
+nano docker-compose.yaml
 </code>
-L'image 1password/scim avec le tag v2.9.15 doit apparaître dans la liste des images Docker disponibles.
+Copier coller le fichier ci-dessous :
-===== Fichier de configuration Docker Compose =====
 <file yaml docker-compose.yaml>
@@ Ligne 173: / Ligne 172: @@
     name: credentials
 </file>
+Sur 1password portail admin, accéder a votre entreprise gérée puis dans intégration> approvisionnement automatique> sélectionnez Entra Azure AD> télécharger le fichier scimsession et enregistrez votre bearer token.
+==== Configuration de l'application ====
+Dans le dossier 1password de la machine créer le fichier scimsession et y copier le contenu du fichier scimsession récupéré sur le centre admin 1password.
+<code bash>
+nano scimsession
+</code>
+Il faut ensuite créer les paramètres de configuration. Les paramètres de configuration sont à mettre dans un fichier ''.env''. Le format est le nom du paramètre ''='' valeur, sans espace entre le nom du paramètre, le signe ''='' et la valeur. Il peut y avoir des lignes vides et des commentaires commençant par ''#''.
+<code bash>
+nano .env
+</code>
+Exemple de fichier ''.env'' :
+<code bash>
+# URL d'accès extérieur à la VM
+SCIM_TLS_DOMAIN=mysync.scim.exemple.com
+# Adresse email déclaré pour la création du certificat
+SCIM_TLS_EMAIL=admin@exemple.com
+# Port qui sera utilisé pour recevoir les requêtes
+SCIM_PORT=443
+</code>
+===== Redirection de port =====
+La VM doit être accessible de l'extérieur. Elle doit pouvoir être contacté par le service qui va faire la synchronisation (Entra / Okta / etc..). Cet accès doit obligatoirement être sur le port 443/tcp (port HTTPS).
+Sur le routeur avec une IP publique, redirigez le port TCP 443 de l'IP publique en TCP vers le port 443 de l'IP sur le réseau interne de la VM. Voir la documentation du pare-feu utilisé pour réaliser cette opération.
+Le but final est d'héberger une "api web". Il faut donc aussi configurer un nom de domaine (celui de la variable ''SCIM_TLS_DOMAIN'' configuré précédemment) qui pointe vers l'adresse IP publique du routeur.
+Exemple, nous avons une IP publique ''203.0.113.12'' et nom de domaine ''mysync.scim.exemple.com''.
+<code>
+mysync.scim.exemple.com.    A    203.0.113.12
+</code>
+===== Contrôle de l'application =====
+Une fois le contenu du fichier ajouter vous pouvez lancer le docker compose.
+<code bash>
+docker compose up -d
+</code>
+<note>Alternativement, vous pouvez utiliser la commande ''docker compose up'' sans le ''-d'' pour voir les logs en temps réel sur le lancement de l'application.</note>
+Il est possible d'afficher directement les logs lorsque docker compose est en cours.
+<code bash>
+docker compose logs
+</code>
+Pour arrêter et supprimer totalement les dockers en cours.
+<code bash>
+docker compose down
+</code>
+Pour afficher les docker en cours d'utilisation.
+<code bash>
+docker ps
+</code>
+Pour vérifier les paramètres du container.
+<code bash>
+docker inspect dockerid
+</code>
+===== Vérification du fonctionnement =====
+Pour vérifier le bon fonctionnement de la VM, vous devez avoir :
+  * Le nom de domaine externe
+  * Une machine hors réseau pour lancer le test
+  * Le Bearer Token donné lors de la configuration de la synchronisation SCIM sur 1Password.
+Pour des fins d'exemple, nous aurons en domaine ''mysync.scim.exemple.com'' et en token ''API_EXEMPLE_TOKEN''.
+Commande de test avec curl sous Linux :
+<code bash>
+curl --silent --show-error --request GET --header "Accept: application/json" --header "Authorization: Bearer API_EXEMPLE_TOKEN" https://mysync.scim.exemple.com/health
+</code>
+Commande de test avec Invoke-WebRequest sous Windows PowerShell :
+<code powershell>
+Invoke-WebRequest -Headers @{'Accept'='application/json'; 'Authorization'='Bearer API_EXEMPLE_TOKEN'} -Method GET -UseBasicParsing -Uri 'https://mysync.scim.exemple.com/health'
+</code>
+Si tout fonctionne, vous pouvez activer la synchronisation aussi bien sur 1Password que sur votre fournisseur SCIM.