Inviting users to the cloud subscription

If you are assigned the Account Administrator role, you can invite users to access your cloud subscription by using the cloud portal.

Before you begin

If you're not an account administrator, contact your account administrator to either assign you that role, or to invite users for you.

About this task

By default, email invitations are automatically sent to invited users so that they can activate their user accounts. However, you can decide not to send the emails, for example, so that you can assign the roles and permissions users need before they activate their accounts. After you set up the accounts, you can then send the invitation emails by inviting the users again. If users don't receive their invitation emails or they delete them by mistake, you can invite them again; you don't need to delete these users from the subscription first.

If your cloud subscription is set up for Security Assertion Markup Language (SAML) authentication, you can inform your users through your in-house communication channels instead of generating invitation emails.

As an alternative to the cloud portal, you can use the User Management API to invite users to the cloud subscription. For more information, see Example: User Management REST API.

Procedure

To invite users, complete the following steps:

  1. Log in to your cloud subscription.
  2. Navigate to the Access management view.
    • Click All environments > Administer subscription > Access management.
    • Click Admin > Access Management.
    1. On the Users page, click Invite users.
    2. Enter the email address for the user, or users, that you want to add.
      Provide the email address, or addresses, in the following format: local-part@domain, for example, John_Doe@mycompany.com. You can either type email addresses or you can paste copied email addresses into this field. If you add multiple email addresses, separate the entries with a comma or space, or add one email address per line.
      Restriction: The local part of the email address can contain only the following characters: A through Z, a through z, 0 through 9, . (period), - (dash), and _ (underscore).
      Click Next.
    3. Optional: Define the user ID instead of the email, first name, or last name. Click Next.
    4. Choose whether you want to skip sending email invitations to users. Click Invite.
      Note: If you use SAML authentication, you can choose to activate users automatically. If you use this option, the user profiles of these new users will not contain their first and last names if you didn’t specify them in step 2c. Users can manually add the names to their user profiles after they log in to the subscription for the first time.

Results

Email invitations are sent to the specified users. These invitations contain a link to activate their access. The invitation to the subscription is valid for 30 days. However, the activation link expires 30 minutes after the email is sent. If a user tries to activate their access with an expired link, a new invitation email is automatically sent to them. A user can try to activate their account 9 times. If the activation is still not successful, they must contact the account administrator to get their account reactivated.

What to do next

Assign the appropriate environment and role permissions and privileges to the new users. For more information, see Assigning roles and permissions.