Configurer l'agent IA (application demandeuse)
Pour configurer un agent IA en tant qu'application demandeuse pour Cross App Access (XAA), enregistrez l'agent IA, ajoutez les informations d'enregistrement du client, puis affectez des utilisateurs à l'application demandeuse. Vous pouvez activer votre agent IA une fois celui-ci configuré.
Before you begin
- Vous avez l'autorisation de gérer les agents IA de votre org.
- Consultez Paramètres de configuration de l'agent d'IA – Applications de requêtes prises en charge pour connaître les exigences des applications demandeuses.
- Voir ID externes pour les fournisseurs d'agents IA.
- Si vous souhaitez utiliser la méthode d'enregistrement client par clé publique/privée, vous disposez d'une clé Web JSON (JWK) publique. Si vous n'en avez pas encore, vous pourrez en générer une après avoir enregistré l'agent IA.
Procedure
-
Enregistrez l'agent IA depuis l'un des points d'entrée suivants :
- Dans la Console des administrateurs accédez à Directory > Agents IA et cliquez sur Enregistrer l'agent IA.
- Vous pouvez également accéder à Applications et Ressources > Applications et sélectionner une intégration d'application configurée pour Cross application Access. Sélectionnez Affectations machine > Ressources, puis cliquez sur Enregistrer l'agent IA.
- Sous Profil, ajoutez un nom et une description pour votre agent IA.
- Cliquez sur Suivant.
-
Sous Accès et authentification de l'utilisateur > Autoriser les utilisateurs à accéder à cet agent, sélectionnez l'une des options suivantes.
- Créer une nouvelle application OIDC associée à cet agent IA : créer une instance d'intégration personnalisée de l'application OIDC permettant aux utilisateurs de se connecter afin d'accéder à l'agent IA.
- Sélectionner une application existante : sélectionner une instance d'intégration d'application existante dans votre org permettant aux utilisateurs de se connecter afin d'accéder à l'agent IA. Si vous enregistrez un agent IA depuis une application existante, l'application existante est pré-remplie dans cette section.
Pour plus de détails, consultez Paramètres de configuration de l'agent d'IA – Applications de requêtes prises en charge.
Note: Pour les applications OIDC, cette action lie définitivement l'agent IA à l'application. Si vous devez apporter une modification à l'application OIDC liée, supprimez l'agent IA puis recréez-le.L'application que vous sélectionnez dans l'onglet Accès utilisateur joue le rôle d'application demandeuse pour le flux XAA. Elle permet à vos utilisateurs de se connecter à l'application agentique via Okta. Une fois l'utilisateur connecté, l'application agentique peut accéder aux applications de ressources au nom de l'utilisateur connecté.
- Cliquez sur Suivant. Votre agent IA apparaît dans la liste des Agents IA avec le statut EN ATTENTE.
-
Dans l'onglet Enregistrement du client, cliquez sur Configurer à côté de la méthode d'enregistrement du client que vous souhaitez utiliser. Vous pouvez préparer plusieurs méthodes d'enregistrement client, mais vous ne pouvez en activer qu'une seule à la fois.
- Document de métadonnées d'ID client (CIMD) : recommandé pour les agents IA identifiés par une URL hébergée par un développeur.Note: Si vous configurez le CIMD en tant que méthode d'enregistrement du client, vous ne pourrez pas modifier ce paramètre par la suite.
- Saisissez l'URL du CIMD.
- Cliquez sur Activer l'enregistrement du client via CIMD.
- Cliquez sur Activer. L'URL du CIMD s'active et s'affiche dans l'onglet Enregistrement du client pour l'agent IA, ainsi que dans l'onglet Général de l'application liée à l'agent IA. Note: Vous pouvez également ajouter l'URL du CIMD directement à l'application liée à l'agent IA. L'URL est automatiquement configurée en tant que méthode d'enregistrement du client de l'agent IA.
- ID client uniquement : recommandé pour les clients publics qui ne peuvent pas stocker de secret, comme les agents de codage locaux.
- Clé secrète client : recommandée pour les agents IA côté serveur. Cliquez sur Générer une clé secrète et fournissez-la au créateur ou au développeur de l'agent IA.
- Clé publique/privée : recommandée pour les agents IA qui disposent de paires de clés gérées par le créateur.
- Cliquez sur Ajouter une clé publique.
- Saisissez votre clé publique ou cliquez sur Générer une nouvelle clé. Okta crée une clé publique qui est associée à une clé privée que vous pouvez consulter au format JSON ou PEM.
- Cliquez sur Copier dans le presse-papiers et stockez la clé privée en lieu sûr.
- Cliquez sur Terminé.
- Document de métadonnées d'ID client (CIMD) : recommandé pour les agents IA identifiés par une URL hébergée par un développeur.
- Copiez l'identifiant qui apparaît dans le champ ID Client et fournissez-le au créateur ou au développeur de l'agent IA.
-
Cliquez sur Activer.
Note: Si une méthode d'enregistrement du client est déjà active, un bouton Basculer apparaît. Si vous passez à une autre méthode d'enregistrement du client, les détails d'enregistrement d'origine sont désactivés et conservés dans l'onglet Enregistrement du client.
-
Cliquez sur Activer dans la boîte de dialogue qui apparaît.
Note: L'agent IA ne peut pas utiliser cette méthode d'enregistrement du client tant que le créateur ou le développeur de l'agent IA n'a pas implémenté le secret client.
- Pour désactiver le secret ou la clé publique d'un client, cliquez sur les trois points verticaux et sélectionnez Désactiver. Pour le supprimer, cliquez à nouveau sur les trois points verticaux et sélectionnez Supprimer.
- Sélectionnez votre agent IA depuis la liste Directory > Agents IA.
- Cliquez sur l'onglet Accès des utilisateurs.
- Sous Accès des utilisateurs > Utilisateurs et groupes affectés à cet agent, cliquez sur Application > Affectations. L'onglet Affectations apparaît pour votre application SSO associée.
-
Dans l'onglet Affectations, sélectionnez les utilisateurs ou les groupes qui peuvent accéder à l'agent IA. Consultez Affecter une intégration d'apps à un utilisateur et Affecter une intégration d'application à un groupe.
Note: Votre appication SSO associée est au départ inactive. Par conséquent, si vous accédez à cette page depuis la page Applications, elle peut apparaître dans l'onglet Inactive.
-
Sur la page de l'agent IA, sélectionnez Actions > Activer .
Note: L'activation de votre agent IA peut prendre quelques secondes. Attendez que le message Agent IA activé avec succès s'affiche avant de poursuivre la configuration ou l'utilisation de votre agent IA.Vous pouvez également activer l'agent IA de manière indirecte en activant l'application demandeuse associée.
- Accédez à Applications et ressources > Applications.
- Sélectionnez l'onglet Inactive sous la colonne STATUT, et recherchez l'application demandeuse associée que vous souhaitez activer.
- Sélectionnez Activer dans le menu déroulant en regard de votre intégration d'application. L'agent IA est automatiquement activé lorsque vous activez l'application associée.
Pour désactiver l'agent IA, accédez à la page Agent IA et sélectionnez Actions > Désactiver.
Note:-
- La désactivation de votre agent IA peut prendre quelques secondes. Attendez que le message Agent IA désactivé avec succès s'affiche avant de procéder à d'autres configurations.
- L'application demandeuse associée à l'agent IA est également désactivée.