Skip to main content

Resource servercore_iam_user_v1

Creates and manages a control panel (local) user or a federated user using public API v1. Servercore products support Identity and Access Management (IAM). For more information about users, see the official Servercore documentation.

Example usage

resource "servercore_iam_user_v1" "user_1" {
  email       = "mail@example.com"
  role {
    role_name = "member"
    scope     = "account"
  }
}

Argument reference

  • email — (Required) User email address. Changing this creates a new user. We will send authentication instructions to this email.

  • auth_type — (Optional) User authentication type. Changing this creates a new user. Available types are local (for control panel users, to store credentials locally in Servercore) and federated (for federated users, to store credentials in the corporate Identity Provider). The default value is local. If auth_type is federated, the federation argument is required.

  • federation — (Optional) Information about the federation. auth_type must be set to federated.

    • id — (Required) Unique identifier of the federation.

    • external_id — (Required) Unique user identifier assigned by the Identity Provider.

  • role — (Optional) Manages service user roles. You can add multiple roles—each role in a separate block.

    • role_name — (Required) Role name.

    • scope — (Required) Role scope. Available scopes are account and project. If scope is project, the project_id argument is required.

    • project_id — (Optional) Unique identifier of the associated project. Changing this creates a new service user. If scope is project, the project_id argument is required. Retrieved from the servercore_project_v2 resource. Learn more about Projects.

Attributes reference

  • keystone_id — Unique Keystone identifier of the user.