Référence Pour: administrateurs

Erreurs d'identité

Causes et solutions des codes d'erreur renvoyés lors de la modification des rôles et des autorisations.

error.identity.group_exists

Texte dans la console
Un groupe nommé {group} existe déjà.
Signification pour les clients de l'API
A local group with that name exists (names are compared without regard to case).
Code
ALREADY_EXISTS, HTTP 409
ArgumentContenu
grouple nom déjà pris.

Cause. Un groupe local de ce nom existe déjà. Les noms de groupe sont comparés sans tenir compte de la casse : Ops et ops sont le même groupe.

Solution.

  1. Utilisez le groupe existant : kyvernon users groups get <name>.
  2. Ou choisissez un autre nom.

error.identity.group_not_found

Texte dans la console
Il n'existe aucun groupe nommé {group}.
Signification pour les clients de l'API
No local group has that name.
Code
NOT_FOUND, HTTP 404
ArgumentContenu
grouple nom demandé.

Cause. Aucun groupe local ne porte ce nom. Le groupe a peut-être été renommé ou supprimé.

Solution.

  1. Listez les groupes : kyvernon users groups list.
  2. Utilisez le nom actuel du groupe.

error.identity.group_cycle

Texte dans la console
Le groupe {member} ne peut pas être imbriqué dans {group} : un groupe se contiendrait lui-même, ou l'imbrication dépasserait huit niveaux.
Signification pour les clients de l'API
Nesting member in group would make a group contain itself, or nest deeper than eight levels.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
grouple groupe qui recevrait le membre.
memberle groupe qui serait imbriqué.

Cause. Un groupe deviendrait membre de lui-même : directement, ou par les groupes qui y sont imbriqués. L'imbrication est aussi limitée à huit niveaux.

Solution.

  1. Consultez l'imbrication : kyvernon users groups get <name> montre les groupes imbriqués et les groupes dont il est membre.
  2. Imbriquez les groupes dans l'autre sens, ou retirez un niveau d'imbrication avec kyvernon users groups remove-group <name> <member>.

error.identity.oidc_unreachable

Texte dans la console
Le fournisseur d'identité {issuer} n'a pas répondu. Les paramètres n'ont pas été modifiés.
Signification pour les clients de l'API
The identity provider did not answer OpenID Connect discovery at issuer; the stored provider is unchanged.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentContenu
issuer: l'URL de l'émetteur qui n'a pas répondu.

Cause. Avant d'enregistrer un fournisseur d'identité, le contrôleur lit son document de découverte (<issuer>/.well-known/openid-configuration). Il n'a pas reçu de réponse valide ; les paramètres enregistrés n'ont pas changé.

Solution.

  1. Vérifiez l'URL de l'émetteur : c'est l'adresse que le fournisseur indique comme émetteur, sans /.well-known/....
  2. Vérifiez que le contrôleur joint le fournisseur (DNS, pare-feu, proxy) et fait confiance à son certificat TLS.
  3. Enregistrez de nouveau les paramètres : kyvernon users set-oidc --issuer <url> --client-id <id> --client-secret-file <file> --redirect-uri <url>.

error.identity.policy_invalid

Texte dans la console
La valeur de stratégie {field} est hors limites.
Signification pour les clients de l'API
A password or lockout policy value is out of range (field names it).
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
fieldle champ de la requête qui contient la valeur, par exemple minLength ou autoUnlockIntervalSeconds.

Cause. Une valeur de la stratégie de mots de passe ou de la stratégie de verrouillage est hors limites. Le mot de passe le plus court compte au moins 12 caractères et le plus long au plus 256, et pas moins que le plus court. La stratégie de verrouillage compte de 1 à 1000 échecs de connexion dans une fenêtre de 1 seconde à sept jours, et déverrouille un compte automatiquement après 1 seconde à sept jours ; un compte que seul un administrateur peut déverrouiller n'est pas proposé.

Solution.

  1. Consultez la stratégie actuelle : kyvernon users password-policy ou kyvernon users lockout-policy.
  2. Enregistrez-la de nouveau avec une valeur dans les limites : kyvernon users set-password-policy --min-length <n> --max-length <n> ou kyvernon users set-lockout-policy --max-failed-attempts <n> --failed-attempt-interval <n> --auto-unlock-interval <n>.

error.identity.provider_privilege_in_tenant

Texte dans la console
Le rôle {role} contient {privilege}, qui ne peut pas être accordé dans les dossiers et pools d’un locataire.
Signification pour les clients de l'API
The role holds a provider-only privilege (Kyvernon.Firewall.ManageProvider, Kyvernon.Firewall.Bypass), which cannot be granted inside a tenant's folders and pools.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
rolele nom du rôle.
privilegele privilège réservé au fournisseur que le rôle détient.

Cause. Un rôle qui détient un privilège réservé au fournisseur (Kyvernon.Firewall.ManageProvider ou Kyvernon.Firewall.Bypass) s'appliquerait dans les dossiers et groupes de ressources d'un locataire. Cela arrive dans deux cas : le rôle est accordé sur un objet qui appartient à un locataire, ou un privilège de ce type est ajouté à un rôle qui s'applique déjà dans un locataire. Les locataires ne détiennent jamais de privilèges de fournisseur, quel que soit l'utilisateur ou le groupe.

Solution.

  1. Accordez le rôle sur un objet extérieur au locataire : kyvernon permissions set <entity> <principal> --role <role>.
  2. Pour donner des droits de pare-feu à un utilisateur d'un locataire, utilisez un rôle sans les privilèges réservés au fournisseur. kyvernon roles list montre les privilèges des rôles.
  3. Pour conserver le privilège de fournisseur sur un rôle, créez un rôle distinct et accordez-le uniquement en dehors des locataires : kyvernon roles create <name> --privilege <privilege>.

Version 0.1. Dernière modification : 2026-11-14