Français Deutsch English (United States) Español (Latinoamérica) 日本語 简体中文
search shadow

Menu

Articles dans cette section

Portail des développeurs de Revizto S’abonner

Avatar
Mallory McClure
  • Mise à jour

Le portail des développeurs permet aux propriétaires et aux administrateurs de compte de gérer les intégrations à l’API Revizto. Vous pouvez ajouter et gérer des applications OAuth pour les intégrations à l’API Revizto, activer des applications préconfigurées gérées par Revizto telles que Revizto MCP Server, contrôler quelles intégrations sont disponibles aux membres du compte d’organisation, et gérer les e‑mails de notification de l’API.

Le portail des développeurs utilise OAuth 2.0, qui permet aux utilisateurs d’autoriser une intégration tierce via un flux de connexion et d’approbation Revizto standard.

Les intégrations existantes basées sur des codes d’accès sont toujours prises en charge afin d’assurer la rétrocompatibilité. Les nouvelles intégrations doivent utiliser portail des développeurs et l’enregistrement d’applications OAuth.

Voir aussi :

Autorisations requises

Les utilisateurs ayant le rôle de Propriétaire du compte ou d’Administrateur du compte peuvent consulter et gérer les applications depuis le portail des développeurs. Vous pouvez consulter votre rôle de compte depuis la page Informations du compte/Gérer les informations du compte dans Revizto Workspace. Voir Rôles de compte et de licence pour plus d’informations. 

Les utilisateurs standard peuvent consulter les applications actives du compte depuis Intégrations d’applications, mais ils ne peuvent pas ajouter ni modifier des applications, voir les secrets client ni gérer les paramètres.

Les droits d’accès Revizto d’un utilisateur s’appliquent à l’intégration, ce qui signifie qu’elle ne peut accéder qu’aux données auxquelles l’utilisateur Revizto autorisé est habilité à accéder.

Accès au portail des développeurs

Les propriétaires et les administrateurs de compte peuvent gérer les applications OAuth depuis Portail des développeurs dans Revizto Workspace. D’ici, vous pouvez ajouter et gérer des applications personnalisées, activer ou désactiver des applications préconfigurées, gérer les e‑mails de notification de l’API et afficher les intégrations disponibles.

Pour accéder au portail des développeurs :

  1. Connectez-vous à ws.revizto.com.
    • Si vous êtes membre de plusieurs comptes, assurez-vous que le bon compte est sélectionné.

  2. Ouvrez le menu déroulant Outils, puis sélectionnez Gérer les informations du compte. Si vous ne voyez pas Gérer les informations du compte, consultez la section Autorisations requises. 

  1. Cliquez sur Portail des développeurs.

Intégrations d’applications pour les utilisateurs standard

Les utilisateurs standard n’ont pas accès au portail des développeurs, mais ils peuvent consulter les applications de leur compte depuis la page Intégrations d’applications dans Revizto Workspace. 

Intégrations d’applications propose une vue d’ensemble de ce qui est disponible, notamment :

  • Les applications personnalisées actives.
  • Les applications préconfigurées actives.
  • Les descriptions des applications.

Bien que les utilisateurs standard puissent consulter des informations sur les applications depuis Intégrations d’applications, il ne s’agit que d’informations basiques sur ce qui est disponible dans le compte. Les informations détaillées et les fonctions d’administration, notamment les suivantes, ne sont pas inclues :

  • Les applications inactives (personnalisées ou préconfigurées).
  • Les ID client des applications.
  • Les secrets client des applications.
  • Les URI de redirection des applications.
  • Les actions de gestion des applications.

Si vous vous attendez à ce qu’une application soit disponible et qu’elle n’apparaît pas dans Intégrations d’applications, contactez le propriétaire ou un administrateur de votre compte.

Pour accéder à Intégrations d’applications :

  1. Connectez-vous à ws.revizto.com.
    • Si vous êtes membre de plusieurs comptes, assurez-vous que le bon compte est sélectionné.

  2. Ouvrez le menu déroulant Outils, puis sélectionnez Informations du compte.

  1. Cliquez sur Intégrations d’applications.

Types d’applications

Dans le portail des développeurs, il existe deux types d’applications : les applications préconfigurées et les applications personnalisées. 

Applications préconfigurées

Les applications préconfigurées sont gérées par Revizto ou par des partenaires de Revizto et n’ont pas besoin d’être ajoutées par un propriétaire ou un administrateur de compte. Les propriétaires et administrateurs de compte ne peuvent ni voir ni modifier l’ID client, le secret client ou les URI de redirection d’une application préconfigurée ; ils peuvent uniquement activer ou désactiver l’application. Les applications préconfigurées sont désactivées par défaut et doivent être activées avant que les membres du compte puissent les utiliser. 

Les applications préconfigurées incluent Revizto MCP Server, qui permet aux utilisateurs de connecter leurs comptes Revizto à l’outil IA de leur choix. Pour établir une connexion avec un assistant IA, les propriétaires ou administrateurs de compte doivent d’abord activer l’application Revizto MCP Server dans Portail des développeurs. Pour en savoir plus sur la configuration du serveur MCP de Revizto, voir Connexion d’outils IA au serveur MCP de Revizto.

Applications personnalisées

Les applications personnalisées, quant à elles, sont ajoutées au compte par le propriétaire ou un administrateur du compte. Une application personnalisée peut être configurée dans le portail des développeurs et le propriétaire ou les administrateurs du compte doivent gérer les éléments nécessaires à l’établissement de la connexion entre Revizto et l’intégration tierce. 

La configuration des applications personnalisées comprend les éléments suivants : URI de redirection, ID client, secret client et e‑mails de notification de l’API.

URI de redirection

Une URI de redirection est l’adresse où Revizto redirige l’utilisateur après l’approbation ou l’annulation de l’autorisation OAuth. Cette adresse est fournie par l’intégration tierce et peut être appelée « URL de réponse » dans la documentation de l’intégration.

Chaque URI de redirection utilisée par l’intégration tierce doit être enregistrée dans le portail des développeurs. Lors de la configuration d’une application personnalisée, Revizto valide les URI de redirection selon les paramètres suivants :

  • Il y a au moins une URI de redirection. L’ajout de plusieurs URI de redirection est pris en charge. 
  • Le protocole, le domaine et le chemin correspondent exactement. 
  • La casse des caractères correspond. 
  • Les URI de redirection en production utilisent le protocole HTTPS (sauf pour localhost).
  • Le port correspond pour les URI autres que localhost (le port n’est pas validé pour localhost).
  • Toute barre oblique finale correspond exactement et fait partie de l’URI.
  • L’URI ne contient aucun caractère générique.
  • Lors de l’autorisation OAuth, l’URI de redirection utilisée par l’intégration tierce correspond exactement à l’une des URI de redirection enregistrées pour l’application dans le Portail des développeurs.
  • Aucun doublon d’URI de redirection dans la même application personnalisée. 

Exemple :

  • https://app.example.com/oauth/revizto/callback
  • https://integrations.company.com/revizto/oauth/callback
  • http://localhost:3000/oauth/revizto/callback

Si l’autorisation échoue en raison d’une incompatibilité d’URI de redirection, vérifiez la configuration de l’intégration tierce et les URI de redirection enregistrées dans l’application dans le Portail des développeurs.

ID client et secret client

Lorsqu’une application personnalisée est ajoutée, Revizto crée les identifiants ID client et secret client, qui servent d’identifiants pour l’intégration tierce.

  • ID client : Visible et copiable dans le Portail des développeurs. L’intégration tierce l’utilise pour identifier l’application OAuth. 
  • Secret client : Affiché immédiatement après l’ajout d’une application ou après la régénération du secret client. Une fois la fenêtre des identifiants fermée, le secret client ne peut plus être affiché ni copié. 

Après réception du secret client, veillez à le stocker immédiatement de manière sécurisée dans l’intégration tierce ou dans le gestionnaire de secrets de votre entreprise.

Si le secret client est perdu, il peut être régénéré en suivant les étapes de la section Régénération des secrets client. Après la régénération, l’ancien secret client cessera immédiatement de fonctionner et vous devrez mettre à jour l’intégration tierce avec le nouveau secret client.

E‑mails de notification de l’API

Dans les applications personnalisées, les e‑mails de notification de l’API correspondent aux contacts techniques pour l’application et pour votre compte. Ces e‑mails peuvent être gérés lors de l’ajout ou de la modification d’une application personnalisée. 

Revizto envoie à ces adresses e‑mail des mises à jour importantes liées à l’API, telles que :

  • Les modifications de l’API.
  • Les avis d’obsolescence.
  • Les avis de changements incompatibles.
  • Les mises à jour du Portail des développeurs et des intégrations OAuth.

Dans la mesure du possible, utilisez une adresse e-mail partagée afin que votre organisation puisse continuer à recevoir les mises à jour de l’API après un changement de personnel. 

Activation et désactivation d’applications

Les propriétaires et administrateurs de compte peuvent activer et désactiver les applications préconfigurées comme personnalisées. L’état de l’application s’applique à l’ensemble du compte. Les utilisateurs standard ne verront que les applications actives dans Intégrations d’applications.

Lorsqu’une application est désactivée, les membres du compte ne pourront plus utiliser l’intégration tierce pour accéder à Revizto et tous les accès existants ainsi que les nouvelles tentatives d’autorisation OAuth seront bloqués. Lorsqu’une application est réactivée, les utilisateurs peuvent devoir la réautoriser en se reconnectant avec leur compte utilisateur Revizto.

Pour activer ou désactiver une application :

  1. Accédez à Portail des développeurs dans Revizto Workspace.
  2. Recherchez l’application que vous souhaitez activer ou désactiver.

  3. Dans la colonne Active de l’application, activez ou désactivez le commutateur (s’il est bleu, l’application est active).

  1. Dans la boîte de dialogue de confirmation, cliquez sur Activer ou Désactiver pour confirmer votre choix. 

    Vous pouvez également activer ou désactiver une application personnalisée à l’aide du commutateur en haut du volet de modification de l’application, puis suivre les mêmes étapes de confirmation de votre choix. 

L’activation ou la désactivation prend effet immédiatement ; toutefois, les membres du compte devront peut‑être actualiser leur page pour voir le changement.

Ajout d’applications personnalisées

Une application personnalisée est une application OAuth ajoutée à un compte d’organisation. Les applications personnalisées peuvent être utilisées pour des intégrations conçues par votre organisation, configurées par votre équipe d’intégration, ou mises en place par un système tiers qui a besoin d’identifiants OAuth provenant de votre compte Revizto.

Pour ajouter une application personnalisée :

Avant d’ajouter une application personnalisée, confirmez que vous disposez des URI de redirection fournies par l’intégration tierce que vous allez connecter à Revizto.

  1. Accédez à Portail des développeurs dans Revizto Workspace.

  2. Cliquez sur + Ajouter une application personnalisée. 

  1. Dans le champ Nom de l’application, saisissez le nom de l’application.
  2. Dans le champ URI de redirection, saisissez une ou plusieurs URI de redirection. Chaque URI doit respecter les paramètres décrits dans la section URI de redirection ci‑dessus. 
  3. Dans le champ Description, saisissez une description de l’application si nécessaire.
  4. Dans le champ Contacts pour les notifications API, saisissez les adresses e‑mail des utilisateurs qui doivent recevoir les communications liées à l’API de la part de Revizto, ainsi que les changements qui affectent vos intégrations.

  5. Cliquez sur Ajouter en bas du volet Ajouter une application personnalisée.

  1. Dans la fenêtre Informations d’identification de l’application, copiez l’ID client et le Secret client. Après avoir fermé la fenêtre, vous ne pourrez plus accéder au secret client ; veillez donc à stocker ces informations en lieu sûr. 

  2. Cliquez sur OK. 

  1. Ajoutez l’ID client et le secret client nouvellement créés à l’intégration tierce pour achever la connexion.

Après avoir enregistré l’application personnalisée, elle sera automatiquement activée et enregistrée sous Applications personnalisées. 

Modification d’applications personnalisées

Les propriétaires et administrateurs de compte peuvent modifier le nom, la description, les URI de redirection et les e‑mails de notification de l’API dans les applications personnalisées. Aussi bien les applications personnalisées actives que celles inactives peuvent être modifiées. Si vous devez obtenir un nouveau secret client, consultez la section Régénération des secrets client.

Pour modifier une application personnalisée :

  1. Accédez à Portail des développeurs dans Revizto Workspace.
  2. Cliquez sur l’application personnalisée que vous souhaitez modifier.

  3. Dans le volet de modification de l’application, modifiez les champs souhaités.

    Si vous modifiez une URI de redirection, vous devez également mettre à jour la configuration de l’intégration tierce  ; sinon, les tentatives d’autorisation OAuth utilisant l’URI d’origine échoueront.

  1. Cliquez sur Mettre à jour en bas du volet de modification de l’application.

Suppression d’applications personnalisées

Les propriétaires et administrateurs de compte peuvent supprimer des applications personnalisées. Seules les applications inactives peuvent être supprimées. La suppression d’une application la retire définitivement de la liste des intégrations d’applications disponibles dans le compte.

Pour supprimer une application personnalisée :

  1. Accédez à Portail des développeurs dans Revizto Workspace.
  2. Désactivez l’application personnalisée que vous souhaitez supprimer.
  3. Dans la colonne Actions de l’application, cliquez sur Supprimer .
  4. Dans la fenêtre Supprimer l’application, saisissez dans le champ de confirmation le nom de l’application exactement tel qu’il apparaît dans la fenêtre.

  5. Cliquez sur Supprimer.

    Vous pouvez également supprimer une application personnalisée inactive en cliquant sur Supprimer en haut du volet de modification de l’application, puis en suivant les mêmes étapes de confirmation de votre choix. 

L’application sera immédiatement supprimée et tous les accès existants seront révoqués. Si vous souhaitez à l’avenir ajouter de nouveau la même intégration tierce, vous devrez ajouter une nouvelle application personnalisée.

Régénération des secrets client

Si le secret client d’une application personnalisée est perdu, révélé ou doit être modifié, il peut être régénéré. Lorsqu’un secret client est régénéré :

  • L’ancien secret client cesse immédiatement de fonctionner.
  • Le nouveau secret client n’est affiché qu’une seule fois.
  • L’intégration tierce doit être mise à jour avec le nouveau secret client pour continuer à fonctionner.

Pour régénérer un secret client :

  1. Accédez à Portail des développeurs dans Revizto Workspace.
  2. Recherchez l’application personnalisée dont vous souhaitez régénérer le secret client.
  3. Dans la colonne Actions de l’application, cliquez sur Afficher les informations d’identification.

  4. Dans la fenêtre Informations d’identification de l’application, cliquez sur Régénérer le secret client à côté de Secret client.

  1. Dans la fenêtre de confirmation, cliquez de nouveau sur Régénérer le secret client pour confirmer votre choix. 
  2. Dans la fenêtre Informations d’identification de l’application, copiez le nouveau secret client. Après avoir fermé la fenêtre, vous ne pourrez plus accéder au secret client ; veillez donc à stocker ces informations en lieu sûr. 

  3. Cliquez sur OK.

  1. Ajoutez le secret client nouvellement créé à l’intégration tierce pour rétablir la connexion.

Dépannage

Q : Je ne peux pas ajouter d’application personnalisée.

R : Seuls les propriétaires et administrateurs de compte peuvent ajouter des applications personnalisées. Demandez au propriétaire ou à un administrateur de votre compte de mettre à jour votre rôle de compte ou d’ajouter l’application pour vous.


 

Q : J’ai perdu le secret client d’une application personnalisée.

R : Le secret client peut être régénéré en suivant les étapes de la section Régénération des secrets client. Une fois régénéré, copiez et enregistrez immédiatement le nouveau secret client en lieu sûr et mettez à jour l’intégration tierce.


 

Q : Les membres du compte ne peuvent pas autoriser leur compte Revizto dans l’intégration tierce.

R : Confirmez les points suivants :

  • L’état de l’application concernée est Actif.
  • L’intégration tierce utilise le bon ID client.
  • L’intégration tierce utilise le secret client actuel.
  • L’URI de redirection dans l’intégration tierce correspond exactement à une URI de redirection répertoriée dans les informations de l’application.
  • L’utilisateur a accès au compte Revizto.


 

Q : Les membres du compte pouvaient auparavant se connecter à une application, mais ce n’est plus le cas.

R : Confirmez les points suivants :

  • L’état de l’application est toujours Actif.
  • L’application n’a pas été supprimée.
  • Si le secret client a été régénéré, le nouveau secret client a été mis à jour dans l’intégration tierce.


 

Q : Je ne vois pas l’application Revizto MCP Server dans mes applications disponibles. 

R : L’application Revizto MCP Server est une application préconfigurée et doit être activée pour le compte. Demandez au propriétaire ou à un administrateur de votre compte de confirmer que l’application Revizto MCP Server est active dans le Portail des développeurs.

Articles associés