Skip to main content

IAMRole

Available

Deployed and supported. The fields and commands described here are stable within version v1alpha1.

Legacy way of managing

The roles and permissions that your applications read in their users' tokens are managed with sng iam role or the Authentication section of the console (Users of your applications). An IAMRole no longer declares them: this manifest is kept for existing installations and is not linked to your applications' user directory.

apiVersioniam.stackngo.io/v1alpha1
kindIAMRole
Applied bysng apply
Related commandssng template gen IAMRole, sng kind get IAMRole, sng kind delete IAMRole

What it is for​

An IAMRole used to declare a role in YAML: a name that your applications read in their users' token. For new roles meant for your users, use sng iam role.

Fields​

IAMRole​

ChampDescriptionDéfautValidation
apiVersion stringiam.stackngo.io/v1alpha1
kind stringIAMRole
metadata ObjectMetaSeul metadata.name est à renseigner (nom de la ressource dans votre tenant).
spec IAMRoleSpec
status IAMRoleStatus

IAMRoleSpec​

ChampDescriptionDéfautValidation
displayName stringNom affiché du rôle.
childRoles string arrayNoms des rôles rattachés à celui-ci.
assignableByApplications string arrayNoms des applications autorisées à attribuer ce rôle.
deletionPolicy DeletionPolicySort du rôle quand le manifeste est supprimé : Block (défaut), Orphan ou Delete.BlockEnum: [Block Orphan Delete]

IAMRoleStatus​

ChampDescriptionDéfautValidation
observedGeneration integerDernière version du manifeste (metadata.generation) prise en compte par la plateforme.
provider ProviderStatusIdentité de la ressource dans le service d'authentification.
lastSyncedAt TimeDate de la dernière prise en compte réussie du manifeste.Optional: {}
conditions Condition arrayConditions décrivant l'état actuel de la ressource (Ready…).

DeletionPolicy​

Type sous-jacent : string

DeletionPolicy indique ce que devient la ressource quand vous supprimez son manifeste : Block bloque la suppression tant que la ressource est encore utilisée, Orphan la conserve, Delete la supprime.

Règles de validation :

  • Enum: [Block Orphan Delete]
ValeurDescription
BlockBloque la suppression tant que la ressource est encore utilisée par une autre.
OrphanSupprime le manifeste mais conserve la ressource créée.
DeleteSupprime la ressource avec le manifeste, sans vérifier son usage.

ProviderStatus​

ProviderStatus identifie la ressource dans le service d'authentification.

ChampDescriptionDéfautValidation
owner stringOrganisation propriétaire de l'objet dans l'annuaire d'identité. Renseigné par la plateforme.
name stringNom de l'objet dans l'annuaire d'identité. Renseigné par la plateforme.
resourceID stringIdentifiant de l'objet dans l'annuaire d'identité. Renseigné par la plateforme.

See also​