Skip to main content

IAMGroup

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 or the Authentication section of the console (Users of your applications). An IAMGroup no longer declares them: this manifest is kept for existing installations and is not linked to your applications' user directory.

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

What it is for​

An IAMGroup used to declare a group in YAML: a team, an agency, a customer. For new groups meant for your users, use sng iam.

Fields​

IAMGroup​

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

IAMGroupSpec​

ChampDescriptionDéfautValidation
displayName stringNom affiché du groupe.
parentRef ObjectReferenceGroupe parent, dans votre tenant, pour organiser les groupes en arbre. Absent : groupe de premier niveau.Optional: {}
deletionPolicy DeletionPolicyBlockEnum: [Block Orphan Delete]

IAMGroupStatus​

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

ObjectReference​

ObjectReference désigne une autre ressource IAM de votre tenant.

ChampDescriptionDéfautValidation
name stringNom de la ressource désignée, dans votre tenant.MaxLength: 253
MinLength: 1

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​