Authentification

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

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).
• 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 ou votre service d'assistance.
• Fournisseur d'identité externe — choisissez Votre organisation, entrez votre adresse courriel professionnelle pour trouver votre organisation, puis terminez la connexion avec le fournisseur d'identité de votre organisation. C'est aussi le parcours pour les régions AWS GovCloud (US).

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

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.

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.

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.

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.

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é.

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

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

Sur Windows :

$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.

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.

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

1. Allez dans Paramètres et sélectionnez l'onglet Agent.
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.

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).

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.

• Configurer votre premier projet
• Découvrir la protection de la vie privée et des données
• Configurer les fournisseurs d'identité d'entreprise