Skip to main content

Organization User

OrganizationUser​

Individual user in the Infrastream platform.

The identity record of a person: legal name, primary email and links to external accounts such as GitHub.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be OrganizationUser.
metadatamapThe engine reads the reserved keys name and organization to resolve the identity of the manifest and its parent Organization.
specSpecUser configuration. See Spec.

Spec​

Desired user configuration.

Legal name, Google account, accounts in external systems and extra email addresses.

PropertyTypeDescription
identityIdentityLegal name of the user, for the identity in the identity provider of the organization. The engine does not derive the email address from it: declare the address in primaryEmail. See Identity.
externalAccountslist of UserExternalAccountAccounts of the user in external systems, such as GitHub. The engine maps them to GitHub team and repository access. They do not create GCP IAM bindings.
emailAliaseslist of stringAdditional fully qualified email addresses. With GoogleWorkspace federation they become directory aliases. With InfrastreamManaged federation the engine recognizes them for an authenticated caller but does not register them with Google. The user still signs in as primaryEmail.
primaryEmailstringGoogle account of the user. Required. The user must already own this address, for example a consumer account or a Workspace account. With InfrastreamManaged federation, Infrastream does not create the account. It allowlists the address and binds it as an IAM principal. An address that is not a real Google identity cannot sign in or get access. With GoogleWorkspace federation, Infrastream creates the account with this address. Use the real address of the user, not one built from metadata.name and a domain.

Identity​

Legal name components of the user.

First, middle and last name. The display name of the provisioned identity uses only the first and last names.

PropertyTypeDescription
firstNamestringLegal first name.
middleNamestringNOT YET IMPLEMENTED. The engine ignores this field.
lastNamestringLegal last name.

UserExternalAccount​

Link from a platform user to an external identity.

Adds the user to GitHub organizations and teams.

PropertyTypeDescription
sourceTypestringExternal identity system. The only value is GITHUB.
sourceNamestringName of the GithubConnection manifest that resolves the username.
usernamestringLogin name of the user in the external system.