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.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be OrganizationUser. |
| metadata | map | The engine reads the reserved keys name and organization to resolve the identity of the manifest and its parent Organization. |
| spec | Spec | User configuration. See Spec. |
Spec
Desired user configuration.
Legal name, Google account, accounts in external systems and extra email addresses.
| Property | Type | Description |
|---|---|---|
| identity | Identity | Legal 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. |
| externalAccounts | list of UserExternalAccount | Accounts 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. |
| emailAliases | list of string | Additional 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. |
| primaryEmail | string | Google 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.
| Property | Type | Description |
|---|---|---|
| firstName | string | Legal first name. |
| middleName | string | NOT YET IMPLEMENTED. The engine ignores this field. |
| lastName | string | Legal last name. |
UserExternalAccount
Link from a platform user to an external identity.
Adds the user to GitHub organizations and teams.
| Property | Type | Description |
|---|---|---|
| sourceType | string | External identity system. The only value is GITHUB. |
| sourceName | string | Name of the GithubConnection manifest that resolves the username. |
| username | string | Login name of the user in the external system. |