Passer au contenu principal
Afficher en Markdown

Authentification

Kiro prend en charge plusieurs fournisseurs d'authentification sur toutes les surfaces :

FournisseurIDEVS CodeCLIWebMobile
GitHub✓✓✓✓✓
Google✓✓✓✓✓
AWS Builder ID✓✓✓✓✓
AWS IAM Identity Center✓✓✓✓✓
Fournisseur d'identité externe✓✓✓✓✓
Clé API (CI/sans interface)✓

Se connecter à Kiro

Les fournisseurs fonctionnent de la même façon partout, et la connexion se termine dans le navigateur :

  • GitHub, Google et AWS Builder ID — choisissez le fournisseur, authentifiez-vous dans votre navigateur et autorisez l'application Kiro (sur GitHub, l'application à autoriser apparaît sous le nom kirodotdev).
  • Votre organisation - Si votre compte Kiro est géré par un administrateur, choisissez Votre organisation. Vous pouvez utiliser AWS IAM Identity Center ou un fournisseur d'identité externe comme Okta ou Microsoft Entra ID :
    • AWS IAM Identity Center — vous aurez besoin de l'URL de démarrage et de la région AWS qui héberge votre répertoire d'identités, fournies par votre administrateur.
    • Fournisseur d'identité externe — entrez votre adresse courriel professionnelle ou l'URL de démarrage Kiro fournie par votre administrateur. C'est aussi le parcours pour les régions AWS GovCloud (US).

La façon de lancer le processus diffère selon la surface :

  1. Sur l'écran d'accueil, choisissez votre méthode de connexion. Kiro redirige vers votre navigateur Web par défaut pour terminer le processus de connexion.
  2. Dans votre navigateur, choisissez votre fournisseur et authentifiez-vous.
  3. Une fois authentifié, vous recevez un message dans votre navigateur vous redirigeant vers votre IDE, où vous êtes connecté.

Se reconnecter après l'expiration de votre session (IDE)

Lorsqu'une session ouverte avec AWS IAM Identity Center ou AWS Builder ID expire, Kiro IDE affiche Your Kiro session expired. Reconnect to suivi de votre URL de démarrage ou de AWS Builder ID. Sélectionnez Reconnect pour vous reconnecter avec la même connexion. Vous n'avez pas à choisir de méthode de connexion ni à entrer de nouveau l'URL de démarrage et la région AWS; vous terminez seulement l'étape dans le navigateur.

  • Lorsque la reconnexion réussit, l'IDE affiche Reconnected to Kiro.
  • Lorsqu'elle échoue, l'IDE affiche We could not reconnect to Kiro. Please sign in again. avec un bouton Sign in qui lance une connexion normale. Si votre administrateur n'autorise pas cette méthode de connexion, l'IDE affiche le message de politique de connexion de votre administrateur à la place du texte générique.
  • Si vous fermez l'invite ou annulez dans le navigateur, vous restez déconnecté jusqu'à ce que vous vous connectiez de nouveau.

Kiro propose la reconnexion seulement après une connexion avec IAM Identity Center ou AWS Builder ID. Les connexions avec GitHub, Google et un fournisseur d'identité externe n'affichent pas cette invite, et une connexion avec l'un d'eux efface toute connexion IAM Identity Center ou AWS Builder ID mémorisée. L'exécution de Kiro : Sign Out l'efface aussi, de sorte qu'aucune invite de reconnexion n'apparaît après une déconnexion volontaire.

Authentification sur une machine distante (CLI)

Lorsque vous exécutez Kiro CLI sur une machine distante (via SSH, SSM, conteneurs, etc.), l'authentification fonctionne différemment, car la machine distante ne peut pas ouvrir de navigateur.

Flux d'appareil

Builder ID, IAM Identity Center, Google et GitHub prennent en charge l'authentification par flux d'appareil dans les environnements distants. La CLI affiche une URL et un code à usage unique que vous entrez dans n'importe quel navigateur — aucune redirection de port n'est nécessaire.

Votre organisation peut désactiver la connexion par flux d'appareil pour un profil Kiro. La CLI masque ce profil pendant la connexion par flux d'appareil et le changement de profil. S'il ne reste aucun profil disponible, exécutez kiro-cli login sur une machine qui peut terminer la connexion par navigateur. La connexion par navigateur n'est pas touchée.

  1. Exécutez kiro-cli login et sélectionnez votre méthode de connexion (par exemple, Utiliser avec Builder ID, Utiliser avec Google, Utiliser avec GitHub ou Utiliser avec votre organisation).
  2. La CLI affiche une URL et un code à usage unique.
  3. Ouvrez l'URL dans n'importe quel navigateur (sur votre machine locale, votre téléphone ou un autre appareil).
  4. Entrez le code et terminez l'authentification.
  5. La CLI détecte automatiquement la connexion réussie.

Authentification par clé API (CLI)

Pour les pipelines CI/CD et les scripts d'automatisation, vous pouvez vous authentifier à l'aide d'une clé API plutôt que par une connexion interactive.

Générer une clé API

  1. Connectez-vous à app.kiro.dev avec votre compte Kiro Pro, Pro+, Pro Max ou Power.
  2. Accédez à la section API Keys.
  3. Créez une nouvelle clé API et copiez-la. La valeur complète de la clé n'est affichée qu'au moment de la création. Donnez-lui un nom significatif pour vous souvenir du contexte de la clé.

Utiliser la clé API

Définissez la variable d'environnement KIRO_API_KEY et exécutez Kiro CLI en mode non interactif :

bash
export KIRO_API_KEY=ksk_xxxxxxxx kiro-cli chat --no-interactive "your prompt here"

Sur Windows :

powershell
$env:KIRO_API_KEY = "ksk_xxxxxxxx" kiro-cli chat --no-interactive "your prompt here"

L'authentification par clé API prend en charge toutes les fonctionnalités de Kiro CLI offertes en mode non interactif. Pour les sessions interactives, utilisez plutôt la connexion par navigateur. Pour les pipelines CI/CD, les scripts d'automatisation et une utilisation détaillée sans interface, consultez Mode sans interface.

Priorité d'authentification

Lorsque plusieurs identifiants sont disponibles, Kiro CLI utilise cet ordre de priorité :

  1. Session de navigateur active (à partir de kiro-cli login)
  2. Variable d'environnement KIRO_API_KEY
  3. Aucun identifiant — la CLI vous invite à vous connecter

Pour vérifier quelle méthode d'authentification est active, exécutez kiro-cli whoami. Les crédits consommés à l'aide de la clé API sont déduits des crédits de votre abonnement.

Connecter GitHub (Web)

Connectez votre compte GitHub pour donner à l'agent accès à vos dépôts :

  1. Allez dans Paramètres > Intégrations.
  2. Sous GitHub, cliquez sur Connecter GitHub.
  3. Autorisez l'application GitHub Kiro Agent.
  4. Sélectionnez les dépôts auxquels l'agent peut accéder.

Vous devez avoir des droits d'écriture sur les dépôts pour que l'agent puisse créer des branches et ouvrir des pull requests.

Comment fonctionne l'accès aux dépôts : Kiro Web affiche tous les dépôts pour lesquels les deux conditions suivantes sont remplies :

  1. Votre utilisateur GitHub a accès au dépôt.
  2. L'application GitHub Kiro Agent a été installée et autorisée pour ce dépôt.

Cela signifie que vous voyez les dépôts des comptes personnels, des dépôts partagés et des organisations — pourvu que votre utilisateur GitHub et l'application Kiro Agent y aient tous deux accès.

Consultez le guide d'intégration GitHub pour des instructions de configuration détaillées.

Régions AWS GovCloud (US)

Pour utiliser Kiro avec AWS GovCloud (US) :

  • Assurez-vous que l'URL de démarrage utilisée lors de l'authentification contient « us-gov-home , par exemple : https://start.us-gov-home.awsapps.com/directory/d-XXXXXXXXXX
  • Kiro utilise le même téléchargement/installateur pour les régions commerciales et les régions AWS GovCloud (US). L'authentification IAM Identity Center achemine automatiquement le trafic vers la région AWS GovCloud (US) appropriée.
  • Kiro IDE version 0.9.2+ et Kiro CLI version 1.25.0+ sont requis pour la prise en charge des régions AWS GovCloud (US).
  • Les administrateurs peuvent aussi connecter un fournisseur OIDC personnalisé; les utilisateurs d'un tel profil sont abonnés à leur première connexion.

Se déconnecter

Pour vous déconnecter de Kiro IDE, ouvrez la palette de commandes et exécutez Kiro : Sign Out. Pour savoir comment la déconnexion influe sur la reconnexion, consultez Se reconnecter après l'expiration de votre session.

Dépannage

Si vous rencontrez des problèmes pendant le processus d'authentification, comme des échecs de redirection du navigateur ou des erreurs de connexion, consultez le guide de dépannage pour des solutions propres à chaque plateforme et des correctifs courants.

Prochaines étapes

Page mise à jour : 20 novembre 2026