Skip to content

IAM User Guide

Users are authenticated by identity and access manager (IAM). This authentication ensures that the customer resources stay secure.

Profile

You can access your user information by selecting Profile from the navigation drawer. Here a user can update and edit his information.

Changing Passwords

To change your password

  1. Under your username, click Password .
  2. Provide your current password, a new password and confirm your new password.
  3. Click Save to update your password.

Result: Your password will be updated.

Adding Emails

To add an email

  1. Select the Emails tab, and all your associated emails will be listed.
  2. Click Add Email at the top of the page.
  3. Specify the email label and the new email.
  4. Click ADD EMAIL ADDRESS.
  5. A verification code will be sent to the given email, enter the code in the verification code box.

Result: The email will be automatically verified and added to your list of emails.

To delete an email, click next to the email you want to delete.

Adding Phone Numbers

To add a phone number

  1. Select the PHONE NUMBERS tab, and all your associated phone numbers will be listed.
  2. Click ADD PHONE NUMBER at the top of the page.
  3. Specify the phone number label and the new phone number.
  4. Click ADD PHONE NUMBER to add the phone number.
  5. A verification code will be sent to the given phone number, enter the code in the verification code box.

Result: The phone number will be automatically verified and added to your list of phone numbers.

To delete a phone number, click next to the phone number you want to delete.

Organizations

Organization information can be accessed by selecting the Organizations tab in the navigation drawer.

A table will appear that displays, side by side, the organization names and the user's role in the corresponding organization.

Creating organizations

If the user creates an organization, then he is considered the organization owner. Before a user can have a customer in whitesky.cloud BV, the user must create an organization in IAM.

To create a new organization

  1. Click CREATE NEW ORGANIZATION at the top of the page.

  2. Enter the organization's name and click CREATE to create the organization.

Result: The new organization will be created and added to the list of organizations.

Inviting users

To invite a user to a specific organization

  1. Select Organizations from the navigation drawer. A list of organizations will appear.

  2. Select the specific organization from the organizations list. The organization's details page will appear.

  3. Select PEOPLE from the tabs.

  4. Click INVITE USER.

  5. Choose a role for the user

    • organization owner

    • organization member

      and specify the user's username, email or phone number.

  6. Click Invite User.

Result: An invitation will be sent to the user. Currently, the user's status is "Invitation pending". Once the user accepts the invitation, the user's status will be updated.

Inviting organizations

To invite an organization to another organization:

  1. Select Organizations from the navigation drawer. A list of organizations will appear.

  2. Select the specific organization from the organizations list. The organization's details page will appear.

  3. Select ORGANIZATIONS from the tabs.

  4. Click INVITE ORGANIZATION.

  5. Choose a role for the organization

    • organization owner

    • organization member

      and specify the organization's name.

  6. Click INVITE ORGANIZATION.

Result: The organization will appear in the list of organizations.

Adding Sub-organizations

To add a sub-organization to a specific organization

  1. Select Organizations from the navigation drawer. A list of organizations will appear.
  2. Select the specific organization from the organizations list. The organization's details page will appear.
  3. Select STRUCTURE from the tabs. The organization's structure will be displayed.
  4. Click ADD SUBORGANIZATION, then enter the sub-organization name and click ADD SUBORGANIZATION.

Result: The sub-organization will be added to the organization's structure.

Adding API keys

To add an API Access key:

  1. Select Organizations from the navigation drawer. A list of organizations will appear.
  2. Select the specific organization from the organizations list. The organization's details page will appear.
  3. Select API ACCESS KEYS. The list of existing keys will appear.
  4. Click ADD NEW API KEY.
  5. Enter the API access key information and click CREATE KEY.

Result: The API access key will be created and added to the list of keys.

About Organization Actions

  1. To alter an organization's information:
  2. Select Organizations from the navigation drawer. A list of organizations will appear.
  3. Select the specific organization from the organizations list. The organization's details page will appear.
  4. Select Settings.

In settings, you can perform a number of actions such as

  • Leave an organization
  • Delete an organization
  • Change an organization's description

Settings

In order to facilitate the authentication process, you can set up an access token, an SSH key or use an authenticator application.

Creating access tokens

To create an access token:

  1. Select Settings from the navigation drawer.
  2. Select ACCESS TOKENS and click CREATE ACCESS TOKEN.
  3. Enter the access token label and click CREATE.

Result: The access token will be created and added to the list of access tokens.

Creating SSH keys

To create an SSH key:

  1. Select Settings from the navigation drawer.
  2. Select SSH KEYS and click ADD SSH KEY.
  3. Enter a label and an SSH key.
  4. Click ADD KEY.

Result: The SSH key will be created and added to the list of SSH keys.

About Authenticator Application

To use QR code verification:

  1. Select Settings from the navigation drawer.
  2. Select Authenticator Application.
  3. Click Show Existing QR Code.

Result: Your QR code will appear, which can be used for your authentication.

Shared Information

You can keep track of which organizations have access to your information by clicking on Shared information.

To update your shared information

  1. Select Shared Information from the navigation drawer. The organizations that you share information with will be listed.
  2. Select the specific organization from the organizations list.
  3. Edit your shared information.
  4. Click Update to update the information.

Result: Your shared information will be updated.

Notifications

You can check your notifications by selecting the Notifications tab in the navigation drawer. You will receive notifications about organizations you own or are a member of.

e.g. when the admin creates a customer in whitesky.cloud BV portal with an organization, the organization's owner will get a notification in IAM, where he can accept or reject the request.