ktm login

S'authentifier auprès de Kapptivate via OAuth 2.1 + PKCE

Utilisation

ktm login [flags]

Exemples

# Log in to the production AS (default: app.kapptivate.com)
ktm login

# Log in to a different Kapptivate environment
ktm login --host my-tenant.kapptivate.com

# Or via env var (useful for CI / per-shell pinning)
KAPPTIVATE_HOST=my-tenant.kapptivate.com ktm login

# Add admin scope for shell on agents, reboot, incident closure
ktm login --scope read --scope write --scope admin

# Read-only session (override the default read+write)
ktm login --scope read

# Headless: print URL, don't open browser
ktm login --no-browser

Flags

Flag	Type	Défaut	Description
`--creds-file`	string		Chemin vers le fichier d'identifiants de secours (défaut : $KAPPTIVATE_CREDENTIALS_FILE, sinon ~/.config/kapptivate/credentials.json). Définissez la variable d'environnement plutôt que le flag si d'autres commandes ktm doivent lire ce chemin personnalisé.
`--no-browser`	boolean		Affiche l'URL d'autorisation au lieu d'ouvrir un navigateur (pour les sessions headless / SSH)
`--no-keychain`	boolean		Ignore le trousseau de clés OS ; stocke le token dans un fichier à ~/.config/kapptivate/credentials.json (0600)
`--timeout`	duration	`2m0s`	Durée d'attente du callback navigateur avant d'échouer

Détails

Connexion à Kapptivate via le flux navigateur OAuth 2.1 + PKCE.

Une fenêtre de navigateur s'ouvre, vous vous connectez à Kapptivate (avec 2FA si activé) et autorisez le CLI ktm. Le token d'accès résultant est stocké dans le trousseau de clés OS (macOS Keychain, Linux Secret Service, Windows Credential Manager). Les commandes ktm suivantes utilisent ce token automatiquement, sans avoir besoin de définir KAPPTIVATE_API_KEY.

L'hôte cible provient de --host ou de $KAPPTIVATE_HOST (défaut : app.kapptivate.com). L'URL du serveur d'autorisation OAuth est dérivée comme https://<host>, donc une seule valeur pilote à la fois les appels API et l'authentification, ce qui correspond à la façon dont chaque autre commande ktm résout l'hôte API.

Headless / SSH : passez --no-browser pour afficher l'URL plutôt que d'en ouvrir une. Vous aurez besoin d'un accès réseau au port loopback de cette machine, donc cela fonctionne uniquement si vous pouvez exécuter un navigateur quelque part pouvant atteindre 127.0.0.1 sur cette machine (par exemple via la redirection de port SSH locale).

Les flags globaux (--output, --debug, --host, ...) s'appliquent à toutes les commandes. Consultez la vue d'ensemble de la référence des commandes.

Et ensuite ?

Toutes les commandes

Parcourir la référence complète du CLI.

Démarrage

Installer le CLI et s'authentifier.