Adding an Application
The Create Application page lets administrators register a new software identity that can authenticate to the system and act with assigned policies.
This is typically done for integrations, services, or internal components that need automated access.
Creating an Application
When to create an application
Create an application only when a software service or integration needs its own credential to call the system
Example: an integration, daemon, or third-party client.
Most day-to-day administration will not require creating applications; developers or integration teams often perform this task.
Best practices
Use clear, descriptive names and include the environment in the name (e.g.,
X-Integration-ProdvsX-Integration-Dev).Give applications the least privilege necessary — assign only the policies required.
Rotate secrets periodically and after any suspected compromise.
Keep a secure record (password manager or vault) of generated secrets.
Use version metadata to track deployments and updates.
Prerequisites
You must have Admin role or a role with permission to create applications.
Know the application metadata (name, vendor, version) and any intended policy requirements.
Decide in advance which policies the application needs (you can modify these later).
Application Properties
Client ID / Name
The unique identifier for the application. This is the friendly name or client identifier shown in the Admin Portal.
Software Name
The product or software name for the application.
Vendor
The organization or vendor that owns the application.
Version
The application version string (optional).
Secret / Secret Key
The credential used by the application to authenticate. Generate or reset as needed. Secure this value.
Lockout / Security State
Tracks failed authentication attempts and whether the application is locked.
Assigned Policies
Policies directly applied to the application. Controls permissions the application has.
Application Secrets
🔒Treat the application secret like a password:
🗒️Copy and store it safely immediately after generation.
🔁If the secret is reset later, any clients using the old secret will stop working until updated.
➕How to Create an Application?
🚧To create an Application in the system, please follow the steps below:
Navigate in the Admin Portal to Security → Applications.
Click the Create button.
After, you will be redirected to the Create Application Page
Enter the descriptive properties of the Application:
Software Name: Enter the software product name.
Vendor: Enter the vendor or owner organization.
⭐Version: (Optional) enter a version string.
Click the Save button
After, the Save button will change text and display Please wait...
Next, you will be redirected to the Application Edit Page
Finally, you should see a success notification in the top right-hand corner of the page
Please read the Editing an Application to finish configuring an Application, such as:
Verifying Application configurations
Generating/Creating an Application Secret
⭐Assigning or removing Policies (optional)
What Happens After Creating an Application?
After saving, the application will be registered within the system:
The application record is added to the Applications list.
When you are finished registering the application, you will need to consider and proceed with the following sections.
How will the Application Authenticate
The new Application will use its Security ID (generated) and Secret (user defined) to authenticate to the system.
Quick verification tip
After creation,
Review the application details to confirm the client id, policies, and security state.
Test an authentication from the integration side to ensure the application is allowed to connect.
External References
Last updated