Manage TeamSpace Users

TeamSpace users can manage their own user information and the information for other TeamSpace users. As a TeamSpace user, you can add, edit, delete, and deactivate API developers as TeamSpace users, assign roles to TeamSpace users, and change your password.
lac42
TeamSpace users can manage their own user information and the information for other TeamSpace users. As a TeamSpace user, you can add, edit, delete, and deactivate API developers as TeamSpace users, assign roles to TeamSpace users, and change your password.
TeamSpace users can also create managed data servers and can specify how you want 
Layer7 Live API Creator
 to control API user access to your API endpoints.
For more information about managed data servers, see Database Creation.
In this article:
 
 
2
 
 
Verify the Prerequisite
Before you can manage TeamSpace users, verify that the system administrator has created the TeamSpace for the TeamSpace users that you want to manage.
View the List of TeamSpace Users
TeamSpace users have access to and can create APIs in their TeamSpace.
Follow these steps:
 
  1. Log in to API Creator as a TeamSpace user.
    The APIs page appears. A list of the APIs that are defined in your TeamSpace displays.
  2. Select 
    Your TeamSpace
     from the gear icon menu at the top right of API Creator.
    The TeamSpace Users page appears. TeamSpace users appear in the TeamSpace Users list.
Add a TeamSpace User
Each API developer who creates or manages APIs contained within a TeamSpace must be added as TeamSpace users. Any TeamSpace user can add other TeamSpace users. You can also delete TeamSpace users using the steps in this procedure.
Best Practice: 
Add users to your TeamSpace to grant them access the TeamSpace.
Follow these steps:
 
  1. Log in to API Creator as a TeamSpace user.
    If the 
    default
     TeamSpace is the only TeamSpace that exists, you are the initial TeamSpace user, and you are just starting to use API Creator, the user name for this user is 
    admin
     .
    The APIs page appears.
  2. Select 
    Your TeamSpace 
    from the gear icon menu at the top right of API Creator.
     The gear menu is at the top right of API Creator. The following image shows this menu:
      Screen Shot 2018-02-02 at 5.54.45 PM.png  
    The TeamSpace Users page appears.
  3. Above the list of TeamSpace users, click 
    Add
     (or 
    Delete
    ).
  4. Define the fields on the page, and then save your changes:
    User name
    The TeamSpace user's user name.
    Full name
    The full name for the TeamSpace user.
    Default:
     New user
    Password
    The TeamSpace user's password.
    Show password
    Specifies whether to show the characters that are entered for the password or to hide the password.
    Email
    If you associate authentication tokens with named TeamSpace users, associate the TeamSpace user to an authentication token by defining the email address. The email address becomes the login ID that corresponds to this authentication token.
    Optional:
     Yes
    Lifespan
    The date and time (in days, hours, and minutes) that the authentication token expires for this TeamSpace user.
    Status
    The TeamSpace user's status.
    Values:
     Active or Inactive
    Default:
     Active
The API developer is added as a TeamSpace user.
This TeamSpace user is added with the 
Account Admin
 and 
Account Reader
 roles.
For more information about these roles, see the "Assign Roles to TeamSpace Users" section.
Assign Roles to TeamSpace Users
  1. In API Creator, on the APIs page, select 
    Your TeamSpace
     from the gear icon menu at the top right of API Creator.
    A list of TeamSpace users is shown on the TeamSpace Users page. The 
    admin
     user is selected by default.
  2. Click the TeamSpace user to which you want to assign roles from the list of TeamSpace users.
  3. Click the 
    Roles
     tab.
    All TeamSpace users can view the roles that are assigned to each TeamSpace user.
  4. Assign one or more the following roles to the TeamSpace user, and then save your changes:
    Account Admin
     
    Assigns create, update, and delete access to the TeamSpace, including create and delete access to APIs that are contained within the TeamSpace and the ability to specify authentication providers for the APIs that are contained within the TeamSpace.
    Account Reader
     
    Assigns read-only access to the TeamSpace, including the APIs that are contained within the TeamSpace.
    Data admin
     
    Assigns create, update, and delete access to managed data servers.
     
     
    Data designer
     
    If the TeamSpace has at least one active managed data server, assigns create access to managed databases. TeamSpace users with this role have create, modify, and delete access to the tables in those managed databases.
    System administrator
     
    This role is available only in the 
    Layer7 Live API Creator
     Admin project API (Admin API). This is the default role assigned to the system administrator (
    sa
    ). TeamSpace users with this role can create other TeamSpaces, upload licenses, and change the authentication provider for the Admin API.
The TeamSpace user is assigned the roles.
Change the Password for TeamSpace Users
As the initial API developer user (a TeamSpace user), and you are just starting to use API Creator, change the default password that 
Layer7 Live API Creator
 assigns to you when the system administrator (
sa
) user created the TeamSpace.
Prerequisites:
 Before you can log in to API Creator and change your user password, verify that the 
sa
 user has communicated your username and default password to you.
You can change the TeamSpace user password using the following methods:
  • This is the most common method to changing the TeamSpace user password. Use this option if you are changing the initial TeamSpace user password.
  • auto. By adding 
    LAC_INITIAL_ADMIN_PASSWORD
     as an environment variable or as a Java system property to the Java command line for your server when you start your server.
    For more information about this option, see API Server Startup Options.
Change the TeamSpace User Password using API Creator
  1. Log in to API Creator.
    If the 
    default
     TeamSpace is the only TeamSpace that exists, the 
    sa
     user is the initial TeamSpace user. The user name for this user is 
    admin
     . Log in to API Creator as this user.
    The APIs page appears.
  2. Select 
    Your TeamSpace
     from the gear icon menu at the top right of API Creator.
    A list of TeamSpace users is shown on the TeamSpace Users page. The 
    admin
     user is selected by default.
  3. Edit the password, and then save your changes.
Automate Changes to the TeamSpace User Password
For larger deployments of 
Layer7 Live API Creator
, you can script or automate password updates for the TeamSpace user by POSTing to API Server using the following URL and payload:
URL:
 
https://<base_api_creator_url>/rest/abl/admin/v2/
@authentication
?enablePasswordChange=true
Payload:
{ "username": "<the TeamSpace user's user name>", "password": "<the current password for the TeamSpace user>", "new_password": "<the new password for the TeamSpace user>" }
Change the TeamSpace User Password using cURL
Issue a cURL command using the following URL and payload:
URL:
 
https://<base_api_creator_url>/rest/abl/admin/v2/
@authentication
?enablePasswordChange=true
Payload:
{ "username": "<the TeamSpace user's user name>", "password": "<the current password for the TeamSpace user>", "new_password": "<the new password for the TeamSpace user>" }
Deactivate a TeamSpace User
Follow these steps:
 
  1. Log in to API Creator as a TeamSpace user.
    The APIs page appears.
  2. Select 
    Your TeamSpace
     from the gear icon menu at the top right of API Creator.
    The TeamSpace Users page appears.
  3. From the list of TeamSpace users, click the username for the user you want to deactivate from the TeamSpace Users list.
  4. Clear the 
    Active
     checkbox, and then save your changes.
The TeamSpace user is deactivated.