Comment ajouter une application de provisionnement personnalisée
Ce guide fournit un aperçu complet des étapes nécessaires pour configurer efficacement le provisionnement personnalisé. En suivant ces étapes, vous pouvez rationaliser la gestion des utilisateurs, automatiser l'accès aux outils nécessaires et améliorer la sécurité grâce à des rôles prédéfinis.
1. Créer une application personnalisée
- Connectez-vous à miniOrange Console d'administration.
- Allez dans Apps et cliquez sur Ajouter une application .

- Sous Choisir une application, sélectionnez Provisioning du Toutes les applications menu déroulant.

- Recherchez votre application dans la liste, si votre application n'est pas trouvée. Provisionnement personnalisé et vous pouvez configurer votre application via Provisionnement personnalisé.

- Entrer le Afficher le nom de l'application puis cliquez sur Suivant.

2. Ajouter une autorisation pour les API
- Sélectionner Autorisation et cliquez sur Ajouter une configuration.

- L'utilisateur peut sélectionner l'un des 4 types d'autorisation en fonction de ses besoins.
- Fonction Plug & Play
- porteur
- OAuth 2.0
- Encadrement Sur Mesure
- Lorsque vous sélectionnez le type d'autorisation comme Fonction Plug & Play, ajouter le Nom de l'autorisation, ID client et secret client de l'application que vous configurez avec et cliquez sur Enregistrer.

- Quand vous sélectionnez Type d'autorisation as porteur, ajouter le Token
valeur pour donner accès aux APIS et cliquez sur Enregistrer.

- Quand vous sélectionnez Type d'autorisation as OAuth 2.0, sous Paramètres de la demande, entrez le URL du jeton d'accès , identité du client, Secret client et Informations d'identification du client de l'application que vous configurez, puis cliquez sur Enregistrer.


- Basculer vers Paramètres de réponse onglet et configurer OAuth 2.0 gestion des jetons en définissant Clés de jeton, Détails d'expiration et type de jeton. Cliquez sur Enregistrer.

- Quand vous sélectionnez Type d'autorisation as Encadrement Sur Mesure, sélectionnez la méthode URL, ajoutez l'URL.


3. Créer un utilisateur
- Sélectionner miniOrange vers une application externe et cliquez sur Ajouter une configuration d'événement.

- Ajoutez le Nom de la configuration de l'événement et le point de terminaison de l'API.

- Sélectionnez le Autorisation que vous aviez créé dans Étape 2.

- Ajouter En-têtes si l'API demande d'autres informations.

- Dans la demande Corps, mapper les paramètres de l'API avec les attributs d'un utilisateur dans miniOrange en utilisant @ symbole (vous recevrez une liste déroulante pour sélectionner l'attribut utilisateur).

- Stockez l'identifiant utilisateur que nous recevrons dans la réponse pour le mapper avec d'autres API liées à l'utilisateur et cliquez sur Enregistrer.

- allumer provisionnement pour cet événement pour activer la configuration.

4. Mettre à jour l'utilisateur
- Sélectionner Mise à jour de l'utilisateur final à partir du menu déroulant Choisir un événement.
- Ajouter @ExternalUserId à la fin de votre point de terminaison API pour transmettre l'identifiant de l'utilisateur, puis cliquez sur Enregistrer.

5. Créer un groupe
- Allez dans Groupes >> Gérer les groupes dans le menu de gauche et cliquez sur Créer un groupe dans le coin supérieur droit de la page.

- Entrer Nom du groupe et créer des le groupe.

6. Travail de groupe
7. Rôles et permissions
Avant de configurer les rôles et les autorisations dans l'application, vous devrez configurer les API pour prendre en charge l'attribution des rôles et des autorisations. Veuillez consulter le guide : Guide de configuration des API de rôles et d'autorisations pour configurer les API.
8. Ajouter des utilisateurs
- Allez dans Utilisateurs >> Liste des utilisateurs.
- Cliquez sur Ajouter un utilisateur.

- Entrer le Détails des utilisateurs et l'utilisateur sera créé.

9. Attribuer des utilisateurs
- Cliquez sur Groupes dans le menu de gauche.
- Localisez le groupe que vous avez créé dans Étape 5.
- Affectez des utilisateurs à ce groupe selon vos besoins.

10. Importer des utilisateurs
- Aller à l'onglet Application externe pour miniOrange et cliquez sur Ajouter une configuration.

- Choisissez l'événement comme Demande d'importation d'utilisateur dans la liste déroulante. Ajoutez ensuite l'URL du point de terminaison de l'API avec la méthode HTTP appropriée sélectionnée, conformément aux exigences de l'API de votre application.

- Sélectionnez le Autorisation que vous avez créé dans Étape 2.
- Ajoutez des en-têtes si la requête API les nécessite dans le En-têtes comme indiqué ci-dessous.

- Ajoutez le corps dans la requête API dans x-www-urlencode ou json dans la section Corps si nécessaire, comme indiqué ci-dessous.

- Paramètres avancés
- Rempli le Clé primaire des données des utilisateurs Valeur. Il s'agit de la clé dans la réponse de l'API, qui contient la liste des utilisateurs. Vous pouvez laisser ce champ vide si les données ne sont associées à aucune clé. Si elles sont associées à des clés imbriquées, vous devez les mentionner, séparées par un point (.). Exemple : users.data
- Activer la pagination - Activez ce paramètre si votre API envoie les données utilisateur paginées. Dans ce cas, veillez à ajouter votre clé de pagination dans l'URL, l'en-tête ou le corps du point de terminaison de l'API, selon les besoins de l'API. @Identifiant de pagination Comme indiqué ci-dessous. La valeur de l'identifiant de pagination sera remplacée dynamiquement en fonction des deux paramètres ci-dessous. (Clé de la page suivante et numéro de la page de début).

- Rempli le Page suivante Valeur clé (S'applique uniquement si vous activez la pagination). Il s'agit de la clé de la réponse de l'API, qui contient la valeur de page/décalage suivant à utiliser pour la pagination. Vous pouvez laisser ce champ vide si votre application n'envoie pas la page/le décalage suivant ; dans ce cas, nous effectuerons une itération séquentielle sur les pages.
- Fournir le Numéro de page de démarrage (S'applique uniquement si vous activez la pagination) si vous souhaitez configurer la pagination incrémentielle ; sinon, laissez-le vide.

- Cartographie d'attributs
- Mappez les attributs utilisateur provenant de l'API avec les attributs d'un utilisateur dans miniOrange, que vous souhaitez importer depuis votre application
- Par défaut, vous devez obligatoirement fournir les attributs suivants
- Identifiant d'application externe (configurez l'attribut provenant de l'API, qui est unique pour l'utilisateur. Exemple : identifiant de l'utilisateur, GUID, nom d'utilisateur, e-mail, tout ce que votre application utilise pour d'autres opérations API)
- E-mail principal (doit être l'attribut contenant l'adresse e-mail unique de l'utilisateur)

- De plus, vous pouvez cliquer sur Ajouter un nouvel attribut pour ajouter plus d'attributs que vous souhaitez importer.
- Cliquez sur Enregistrer Pour enregistrer toutes les configurations, vous serez redirigé vers la liste des configurations.
- Maintenant, cliquez sur le Icône d'importation d'utilisateurs pour lancer l'importation des utilisateurs. L'importation prendra quelques secondes, selon le nombre d'utilisateurs présents dans l'application.

- Vous pouvez aller à la Utilisateurs Page de liste pour vérifier les utilisateurs importés. Cette opération peut prendre un certain temps, selon le nombre d'utilisateurs à importer.
- Vous pouvez également consulter les rapports pour les utilisateurs d'importation depuis Rapports -> Rapport sur les opérations en masse, comme indiqué ci-dessous.

11. Importation automatique planifiée
- Accédez à la Automatismes onglet et ouvrez le Planificateurs .

- Pour créer un nouveau planificateur, cliquez sur le Créer un nouveau planificateur .

- Configurez les paramètres du planificateur en choisissant la fréquence (Une fois, toutes les heures, tous les jours, toutes les semaines, tous les mois).
- Spécifiez les détails de planification associés et sélectionnez le Fuseau horaire dans lequel le planificateur doit s'exécuter.
- Une fois configuré, cliquez sur Sauvegarder et Suivant.

- L'étape suivante consiste à configurer la tâche et à l'affecter au planificateur créé en cliquant sur le Attribuer une nouvelle tâche .

- Choisissez l'application à partir de laquelle l'importation doit être effectuée, ainsi que la tâche requise (importer les utilisateurs, les groupes ou les affectations de groupes d'utilisateurs).

- Ensuite, cliquez sur le Attribuer .

À noter: Si vous souhaitez importer des données provenant de plusieurs applications, vous pouvez affecter plusieurs tâches au même planificateur.
- Une fois la configuration terminée, les importations planifiées automatisées s'exécuteront selon la planification définie.
- Pour consulter les détails d'exécution du planificateur, accédez à Rapports Dans le menu de gauche, faites défiler vers le bas pour vérifier Historique du planificateur.

- Ce rapport vous fournira des informations complètes sur l'historique du planificateur. Vous y trouverez la durée et les tâches exécutées pendant les périodes concernées.

Afficher les rapports de provisionnement
Comment accéder aux rapports de provisionnement ?
- Accédez à Rapports Dans le volet de navigation de gauche, recherchez Provisioning, et sélectionnez Rapport d'approvisionnement.

- Filtrez les rapports en précisant Identifiant de l'utilisateur final et Nom de l'application critères. De plus, choisissez le laps de temps pour les rapports. Une fois terminé, cliquez sur le Rechercher.

- Alternativement, vous pouvez cliquer directement sur Rechercher pour récupérer tous les rapports de provisionnement en fonction du temps sans appliquer de filtres spécifiques.