Skip to content

Providing Access for New Users

When developing Cloud Foundry hosted applications for MindSphere, you need access to a MindSphere developer tenant and to the associated Cloud Foundry org.
Likewise, you need access to an operator tenant and the associated Cloud Foundry org for using your applications productively and/or selling them to customers.

This guide describes how to provide access to new developers or operators.

Adding a User to your Tenant

This section explains how to invite new users to your developer or operator tenant and how to grant them access to the Developer Cockpit or the Operator Cockpit, respectively.
The Developer Cockpit allows users to manage application versions and registration workflows on developer tenants. The Operator Cockpit allows users to deploy applications and publish them for productive use.

Prerequisites

  • You are tenant admin.

Creating the User Account

  1. Open the Settings from the Launchpad.
  2. Open the Users tab and click on the plus symbol to add a new user.
  3. Enter the e-mail address of the new user.
  4. Confirm your entry by clicking Save User.

The user receives an e-mail with the link for accessing MindSphere tenant.

Assigning a MindSphere Role

New users only have limited access permissions on their tenant. For accessing the Developer Cockpit, users must be assigned the mdsp:core:Developer or the mdsp:core:DeveloperAdmin role. For accessing the Operator Cockpit, users must be assigned the mdsp:core:OperatorAdmin role.

Follow the steps below to assign a role to a user.

  1. Open the Settings from the Launchpad.
  2. Open the Users tab and select the user.
  3. Click Edit in the editing function field.
  4. Assign the desired role (see above) to the user.
  5. Click on End editing.

The role is successfully assigned to the user.

Uploading Applications

The user can log into Cloud Foundry, but does not yet have access to your Cloud Foundry org, where they can deploy new applications. You first have to assign them a Cloud Foundry role as described in the next section.

Adding a User to your Cloud Foundry Org

Cloud Foundry by MindSphere is integrated with WebKey as an identity provider. This allows users to sign into Cloud Foundry with their MindSphere account.

When purchasing a MindSphere DevOps Plan, the designated administrator automatically receives admin privileges for their Cloud Foundry org. The org can be fully managed using the Cloud Foundry CLI.

Prerequisites

  • You have the OrgManager role for your Cloud Foundry org.
  • You have installed Cloud Foundry CLI.
  • The user has been invited to a developer tenant as described above.
  • The user has logged into Cloud Foundry at least once.

Adding the User to your Cloud Foundry Org

  1. Open a command line interface (CLI).
  2. Configure the proxy settings, if necessary.

    Click here for detailed information on proxy settings

    If you are in a company network behind a proxy, you may have to set the proxies to reach the Cloud Foundry endpoints. Contact your administrator, if you face any timeouts or connectivity problems.

    Set the proxies for the Cloud Foundry CLI as shown below:

    1
    2
    set http_proxy=http://PROXY_IP:PROXY_PORT
    set https_proxy=http://PROXY_IP:PROXY_PORT
    
    1
    2
    export http_proxy=http://PROXY_IP:PROXY_PORT
    export https_proxy=http://PROXY_IP:PROXY_PORT
    
  3. Enter cf login -a https://api.cf.{region}.{mindsphere-domain} --sso.

  4. Open the URL printed by the CLI and log in using your WebKey credentials to get a One Time Code.
  5. Enter the One Time Code in the CLI.

  6. Select your Cloud Foundry org.

  7. Use the following command to add the user to your Cloud Foundry org:

    1
      cf set-org-role {user_name} {org_name} {role}
    

    Info

    A user must have the Cloud Foundry role SpaceDeveloper to push an application.

  8. Alternatively, use the following command to add the user to a particular space:

    1
    cf set-space-role {user_name} {org_name} {space_name} {role}
    

The user has the assigned access permissions for the Cloud Foundry org or space. For more information on changing user permissions in your Cloud Foundry org, refer to the Cloud Foundry How Tos.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.