Providing Access for New Users - Developer Documentation
Skip to content

Providing Access for New Users

When developing Cloud Foundry hosted applications for Insights Hub, you need access to a Insights Hub developer environment (tenant) and to the associated Cloud Foundry org. Likewise, you need access to an operator environment 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 environment

This section explains how to invite new users to your developer or operator environment 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 environment. 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 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 Insights Hub environment.

Assigning a Role

New users only have limited access permissions on their environment. 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 is integrated with WebKey as an identity provider. This allows users to sign into Cloud Foundry with their Insights Hub account.

When purchasing a 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 environment 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:

      set http_proxy=http://PROXY_IP:PROXY_PORT
      set https_proxy=http://PROXY_IP:PROXY_PORT
    
      export http_proxy=http://PROXY_IP:PROXY_PORT
      export https_proxy=http://PROXY_IP:PROXY_PORT
    
  3. Log in to CF using CF CLI. 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.

2.**Select your Cloud Foundry org. **3.Use the following command to add the user to your Cloud Foundry org:

``` bash
  cf set-org-role {user_name} {org_name} {role}
```

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

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

``` bash
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.


Last update: December 11, 2023

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