Home
Managing security
HCL Launch uses a flexible team-based and role-based security model that maps to your organizational structure.
Tokens
Tokens provide authorization for agents, agent relays, users, and external systems or applications from the server. Agents use tokens when they run process steps and communicate with the HCL Launch server and external services.
Updating the agent relay authentication token password
The authentication token password for the agent relay is specified during installation of the agent relay. You can update the authentication token and provide a password for the token by updating the agent relay properties file.

Managing security
HCL Launch uses a flexible team-based and role-based security model that maps to your organizational structure.
- Guidelines for setting up server security
  Although there is no single best way to set up security for the server, the following steps are sufficient in most cases.
- SSL configuration
  With Secure Sockets Layer (SSL) technology, clients and servers can communicate securely by encrypting all communications. Data is encrypted before it is sent and decrypted by the recipient. This communication cannot be deciphered or modified by third-parties. In addition to encryption, SSL can also support authentication.
- Authorization realms
  Use the Authorization Realms pane to create authorization realms and user groups for the server. Groups can be imported from external systems, such as LDAP.
- Authentication realms
  Authentication realms manage users and determine user identity within authorization realms for the server.
- Roles and permissions
  A role is a list of permissions that users have on the HCL Launch server. These permissions include the ability to create, edit, and delete objects, such as applications, environments, and components. The permission also includes the parts of the server interface that users can access.
- Security teams
  Users and groups on the server are assigned roles when they are added to teams.
- Security types
  Security types define categories of objects on the server. You can put all objects into a single category, or you can put them in separate categories and give roles different access rights to different categories.
- Tokens
  Tokens provide authorization for agents, agent relays, users, and external systems or applications from the server. Agents use tokens when they run process steps and communicate with the HCL Launch server and external services.
  - Restricting authentication tokens
    Limit authentication token actions by applying token restrictions to process plug-in steps.
  - Token expiration settings
    Tokens provide authorization for agents, agent relays, users, and external systems or applications from the server. Agents use tokens when they run process steps and communicate with the HCL Launch server and external services. In the Security settings area, you can set time limits for four tokens types.
  - Updating the agent relay authentication token password
    The authentication token password for the agent relay is specified during installation of the agent relay. You can update the authentication token and provide a password for the token by updating the agent relay properties file.
- Checking and resetting the API key and certificate for agents
  You can view the API key of an agent and reset the key.

Updating the agent relay authentication token password

The authentication token password for the agent relay is specified during installation of the agent relay. You can update the authentication token and provide a password for the token by updating the agent relay properties file.

Before you begin

The new authentication token for the server must be available before changing the password. For information about creating a token, see Tokens.

Procedure

Open the agentrelay.properties file located in agent_relay_home/conf directory.
Change the value for the agentrelay.codestation.server_password property to the new password value.
The following is from the sample agentrelay.properties file. The password shown is encrypted.
```
agentrelay.codestation.server_password=pbe{UlfTbYJYm2i7VIN4D0/8dYeqI6T54heliAURNECl0p4l8/3h72Fv2n3G3yylWwdCnRY57wXcLT8=}
```
Specify the new password. The new password is encrypted when the agent relay is started.
```
agentrelay.codestation.server_password=new_password
```
Save your changes and close the file.
Stop the agent relay.
Start agent relay .
Verify that the agents connected through the changed agent relay are connecting.