Claude Platform Docs
AdministrationClaude Platform OAuth

Test et examen des applications

Comment une nouvelle application Linked billing sort de la phase de test et s’ouvre à vos clients, et ce qui se passe lorsque vous modifiez une application en ligne.

Avec Linked billing, un client lie son organisation Claude à votre application OAuth. Une nouvelle application Linked billing commence en test, où seuls les « test users » (utilisateurs de test) que vous désignez peuvent y lier leurs organisations. Pour ouvrir l’application à vos clients, vous la publiez, et Anthropic l’examine.

Si votre organisation utilise le paiement par facture, Anthropic n’examine pas votre application. Consultez Paiement par facture.

Une application est en ligne lorsqu’Anthropic l’a approuvée ou lorsque vous l’avez publiée avec le paiement par facture. Tout client éligible peut lier son organisation à une application en ligne, et les liaisons créées par ses utilisateurs de test sont conservées. Sur la page des applications OAuth dans la Claude Console, le statut d’une application en ligne indique Active.

Tant que l’application n’est pas en ligne, la Console affiche l’un des statuts suivants pour celle-ci :

StatutSignification
TestingVous n’avez pas publié l’application.
In reviewAnthropic examine l’application ou une modification que vous avez apportée pendant qu’elle était en ligne.
Not approvedAnthropic a examiné l’application ou la modification et ne l’a pas approuvée.

Une application qui repasse en examen après une modification n’est de nouveau en ligne qu’une fois qu’Anthropic a approuvé la modification. Chaque application Linked billing possède son propre statut et ses propres utilisateurs de test. Consultez la note dans Étape 1 : Créer l’application du guide Linked billing.

Avant de commencer

Terminez le Processus de configuration du guide Linked billing.

Gérer les utilisateurs de test

Ajouter des utilisateurs de test

  1. Ouvrez la page de l’application depuis la page des applications OAuth dans la Console.
  2. Dans l’onglet Settings, accédez à la liste Test users sous Who can link.
  3. Saisissez l’adresse e-mail du compte Claude d’un utilisateur de test et cliquez sur Add. Répétez l’opération pour chaque utilisateur de test.
  4. Cliquez sur Save changes.

Une fois l’enregistrement effectué, les personnes figurant sur la liste peuvent lier leurs organisations à votre application. Tant que votre application n’est pas en ligne, la page d’approbation Claude, où une personne approuve la liaison, refuse toute autre personne. Pour savoir ce que votre application reçoit alors, consultez Votre URI de redirection reçoit error=access_denied dans le guide Linked billing.

Who can link reste sur Test users only tant que l’application n’est pas en ligne, et vous ne pouvez pas le modifier. La liste peut contenir jusqu’à 10 utilisateurs de test. Chaque adresse doit correspondre exactement à l’adresse du compte, mais la casse n’a pas d’importance. Une adresse avec une étiquette plus, telle que name+test@example.com, compte comme une adresse différente de name@example.com.

Un utilisateur de test lie son organisation depuis votre application et approuve la liaison sur la page qu’utilisent vos clients. Il doit disposer du rôle Admin ou Facturation dans cette organisation. Les étapes correspondent aux étapes 4 à 8 du guide Linked billing. Tester en tant que client dans ce guide vous les présente et indique comment vérifier que la liaison a été établie.

Pour tester l’application vous-même, ajoutez votre propre adresse e-mail à la liste. L’organisation propriétaire de l’application ne peut pas s’y lier, utilisez donc une deuxième organisation Claude qui vous appartient.

Une fois que l’utilisateur de test a lié son organisation, envoyez des requêtes que vous facturez à celle-ci pour essayer votre application. Le test utilise de l’argent réel. Anthropic facture à l’organisation de chaque utilisateur de test les requêtes que vous lui facturez, comme pour n’importe quel client.

Tant que votre application n’est pas en ligne, chaque nouvelle liaison nécessite un « spend cap » (plafond de dépenses) mensuel de 50 $ USD ou moins. Pour les règles relatives au plafond, consultez Tant que votre application est en phase de test dans le guide.

Retirer un utilisateur de test

Le retrait d’un utilisateur de test prend effet immédiatement. Il met fin à toutes les liaisons avec votre application que la personne a approuvées. Une fois qu’une liaison a pris fin, la Claude API refuse les requêtes que vous facturez à cette organisation. Consultez Erreurs attendues.

  1. Si l’onglet Settings comporte des modifications non enregistrées, cliquez sur Save changes ou sur Discard. Tant que vous ne l’avez pas fait, la Console ne vous permet pas de retirer un utilisateur de test enregistré.
  2. Supprimez l’adresse de l’utilisateur de test de la liste Test users.
  3. Lorsque la Console vous le demande, cliquez sur Remove pour confirmer. Vous n’avez pas besoin de cliquer sur Save changes.

Publier l’application

La publication peut vous demander de prouver que vous contrôlez le domaine de votre application, en ajoutant un enregistrement DNS. Anthropic examine ensuite l’application. Une modification DNS prend du temps, commencez donc avant d’avoir besoin que des clients se lient.

Avant de publier, vérifiez les points suivants :

  • L’authentification du client est configurée. Vous ne pouvez pas publier l’application tant qu’elle ne l’est pas.
  • Votre application dispose d’une page d’accueil, que vous définissez dans l’onglet Appearance.
  • Vous pouvez modifier les enregistrements DNS du domaine de la page d’accueil.
  • Chaque URI de redirection se trouve sur le domaine de la page d’accueil ou sur l’un de ses sous-domaines.

Pour savoir ce qui constitue le domaine de la page d’accueil et connaître les exceptions, consultez Règles relatives aux domaines.

Suivez ces étapes pour publier l’application :

  1. Sur la page de l’application dans la Console, cliquez sur Publish app. Une boîte de dialogue s’ouvre.
  2. Si la boîte de dialogue affiche Prove your domain, ajoutez l’enregistrement DNS TXT qu’elle vous fournit là où vous gérez le DNS de votre domaine. Sinon, passez à l’étape 5.
  3. Cliquez sur Check. Si le domaine affiche toujours Not proven yet, consultez Si vous ne parvenez pas à prouver le domaine.
  4. Lorsque le domaine affiche Proven, cliquez sur Continue.
  5. Si la boîte de dialogue affiche une case pour accepter les Linked Billing Terms, cochez-la. Cliquez ensuite sur Publish app dans la boîte de dialogue pour confirmer.

Pendant qu’Anthropic examine l’application, son statut est In review. Pour les résultats possibles, consultez L’examen.

Si vous ne parvenez pas à prouver le domaine

  • Le domaine affiche toujours Not proven yet : Une modification DNS peut prendre jusqu’à 48 heures pour prendre effet. Vous pouvez fermer la boîte de dialogue et revenir plus tard. Si vous étiez en train de publier, cliquez à nouveau sur Publish app. Si vous étiez en train de modifier une application en ligne, refaites la même modification, et la Console vous fournit le même enregistrement jusqu’à son expiration.
  • Check indique que l’enregistrement a expiré : L’enregistrement DNS est valable 30 jours à compter du moment où la Console l’affiche pour la première fois. Passé ce délai, cliquez sur Get a new record et ajoutez le nouvel enregistrement. Un domaine qui affiche Proven reste prouvé.
  • La boîte de dialogue affiche un message à la place d’un enregistrement : Par exemple, le message peut indiquer que votre organisation possède déjà 20 noms de domaine. Vous ne pouvez pas continuer tant que ce problème n’est pas résolu. Si vous avez besoin d’aide, contactez le support.

Règles relatives aux domaines

Un domaine est un nom d’hôte sans www. initial, et votre domaine est celui de votre page d’accueil. Par exemple, le domaine d’une page d’accueil sur https://www.example.com est example.com. Un domaine prouvé se couvre lui-même ainsi que ses sous-domaines.

  • Domaines partagés : Le domaine partagé d’un service d’hébergement n’est pas admissible, utilisez donc un domaine qui vous appartient.
  • URI de redirection locales : Les URI de redirection sur localhost, 127.0.0.1 ou [::1] n’ont pas besoin de se trouver sur le domaine de la page d’accueil.
  • Sous-domaines voisins : Si votre page d’accueil se trouve sur app.example.com, votre domaine est ce sous-domaine, et il ne couvre pas une URI de redirection sur auth.example.com. Une façon d’utiliser les deux consiste à placer votre page d’accueil sur example.com, qui les couvre.
  • Un domaine que votre organisation a déjà prouvé : Votre organisation a peut-être prouvé un domaine auparavant, par exemple pour une autre application. S’il couvre votre page d’accueil et chaque URI de redirection qui n’est pas locale, la boîte de dialogue ignore Prove your domain. Les URI de redirection n’ont alors pas besoin de se trouver sur le domaine de la page d’accueil. Par exemple, avec example.com prouvé, la page d’accueil et une URI de redirection peuvent se trouver sur des sous-domaines différents de celui-ci.

L’examen

À la fin de l’examen, la page de l’application dans la Console affiche le résultat :

  • Anthropic approuve l’application : L’application est en ligne. Who can link affiche alors Any Claude user sans intervention de votre part, et la Console masque la liste Test users.
  • Anthropic n’approuve pas l’application : Le statut de l’application passe à Not approved.

Pendant l’examen et après un résultat Not approved, vos utilisateurs de test conservent leurs liaisons, et vous pouvez toujours ajouter et retirer des utilisateurs de test.

Si l’application n’est pas approuvée

Vous ne pouvez pas republier l’application vous-même. Pour toute question concernant la décision, contactez le support. Vous pouvez toujours modifier l’application, mais une modification ne déclenche pas de nouvel examen.

Modifier une application en ligne

Une modification du nom, du logo, de la page d’accueil ou des URI de redirection d’une application en ligne renvoie l’application en examen. Jusqu’à ce qu’Anthropic approuve la modification, seuls vos utilisateurs de test peuvent lier leurs organisations à l’application. Consultez Jusqu’à ce qu’Anthropic approuve la modification. Les autres modifications, comme les autorisations ou l’authentification du client, ne renvoient pas l’application en examen.

Suivez ces étapes pour modifier le nom, la page d’accueil ou les URI de redirection :

  1. Modifiez l’application dans son onglet Appearance (nom et page d’accueil) ou dans son onglet Settings (URI de redirection).
  2. Cliquez sur Save changes. Une boîte de dialogue s’ouvre avant que quoi que ce soit ne soit enregistré.
  3. Si la boîte de dialogue affiche Prove your domain, prouvez chaque domaine qu’elle mentionne :
    1. Ajoutez l’enregistrement DNS TXT pour le domaine. Cliquez ensuite sur Check. Si le domaine affiche toujours Not proven yet, consultez Si vous ne parvenez pas à prouver le domaine.
    2. Lorsque le domaine affiche Proven, cliquez sur Next domain s’il reste un autre domaine. Sinon, cliquez sur Continue.
  4. Cliquez sur Save and send to review.

La Console enregistre alors la modification, et celle-ci prend effet sans attendre l’examen. Pendant qu’Anthropic examine la modification, le statut de l’application est In review.

Pour modifier le logo, choisissez-le ou supprimez-le dans l’onglet Appearance. La boîte de dialogue s’ouvre immédiatement. Cliquez sur Send to review. Si vous annulez, le logo n’est pas modifié.

Pour modifier à nouveau l’application pendant que son statut est In review ou Not approved, consultez Modifier une application qui n’est pas en ligne.

Lorsque la Console vous demande de prouver un domaine

La Console ne vous le demande que si vous avez modifié la page d’accueil ou une URI de redirection. Elle vérifie également la page d’accueil et les URI de redirection que vous n’avez pas modifiées, la boîte de dialogue peut donc aussi mentionner leurs domaines. Elle ne mentionne que les domaines qu’aucun domaine prouvé de votre organisation ne couvre. Elle ne vérifie pas les URI de redirection locales, mais une modification de l’une d’elles renvoie tout de même l’application en examen.

Après une modification, les URI de redirection peuvent se trouver sur des domaines autres que celui de la page d’accueil si votre organisation prouve chacun d’eux.

Jusqu’à ce qu’Anthropic approuve la modification

Ces règles s’appliquent à partir du moment où vous envoyez la modification en examen :

  • Clients déjà liés : Leurs organisations restent liées, et les requêtes que vous leur facturez continuent de fonctionner. Un client qui dissocie votre application ne peut pas effectuer à nouveau la liaison, sauf si la personne qui l’effectue figure sur la liste Test users.
  • Nouvelles liaisons : Le paramètre Who can link repasse à Test users only. La Console affiche de nouveau la liste Test users, avec les personnes qui y figuraient auparavant.
  • Utilisateurs de test : Vous pouvez ajouter et retirer des personnes de la liste. Le retrait d’une personne met également fin à une liaison qu’elle a créée avec l’organisation d’un client pendant que l’application était en ligne. Consultez Retirer un utilisateur de test.
  • Plafonds de dépenses des organisations liées : Une organisation liée conserve son paramètre de plafond de dépenses actuel, même si son plafond est supérieur à 50 $ USD ou si elle n’a pas de plafond. Un paramètre qu’elle modifie doit respecter les règles de Tant que votre application est en phase de test.

À la fin de l’examen de la modification

L’examen se termine de l’une des deux manières suivantes :

  • Anthropic approuve la modification : L’application est de nouveau en ligne. Tout client éligible peut se lier, la Console masque la liste Test users, et les règles de plafond applicables à une application qui n’est pas en ligne ne s’appliquent plus.
  • Anthropic n’approuve pas la modification : Le statut de l’application passe à Not approved. La modification reste en vigueur, et les règles de Jusqu’à ce qu’Anthropic approuve la modification s’appliquent toujours. Consultez Si l’application n’est pas approuvée.

Modifier une application qui n’est pas en ligne

Suivez ces étapes tant que le statut de l’application est Testing, In review ou Not approved :

  1. Modifiez l’application dans son onglet Appearance (nom, logo et page d’accueil) ou dans son onglet Settings (URI de redirection).
  2. Cliquez sur Save changes. Une modification du logo est enregistrée lorsque vous choisissez ou supprimez le logo.

Aucune boîte de dialogue ne vous demande de confirmer, et la modification ne change pas le statut de l’application.

Lorsque vous enregistrez une modification de la page d’accueil ou d’une URI de redirection, la Console ne vérifie les domaines que lorsque le statut est In review. Une application en test est soumise à la vérification de domaine lors de sa publication. Pendant un examen, la page d’accueil de l’application modifiée et chaque URI de redirection qui n’est pas locale doivent se trouver sur des domaines prouvés de votre organisation. Sinon, la Console refuse la modification, et elle ne vous demande pas de prouver un domaine. Pour passer à un domaine qui n’est pas prouvé, attendez la fin de l’examen.

Paiement par facture

Avec le paiement par facture, Anthropic facture à l’organisation propriétaire de votre application son utilisation de l’API, et cette organisation n’achète pas de crédits prépayés. Votre application commence tout de même en test, et les règles relatives aux utilisateurs de test et au plafond de dépenses s’appliquent toujours. Ensuite, trois points diffèrent :

  • Publier l’application : Sur la page de l’application, cliquez sur Publish app. Cliquez ensuite sur Publish app dans la boîte de dialogue pour confirmer. Anthropic n’examine pas l’application, elle est donc en ligne dès que vous la publiez.
  • Page d’accueil et domaine : Vous ne prouvez aucun domaine, la boîte de dialogue ignore donc Prove your domain. Votre application n’a pas besoin de page d’accueil pour être publiée, et la règle relative aux URI de redirection décrite dans Publier l’application ne s’applique pas. L’authentification du client doit tout de même être configurée au préalable.
  • Modifier une application en ligne : La Console enregistre une modification lorsque vous cliquez sur Save changes ou lorsque vous choisissez ou supprimez un logo. Elle ne vous demande ni de prouver un domaine ni de confirmer, et aucun examen ne suit.

Cette page vous a-t-elle été utile ?