Apps

Apps are used to integrate external services or systems with SpaceONE.
Users can create apps with specific permissions by obtaining a Client ID and Client Secret for API authentication.
This allows you to manage cloud resources and automate various SpaceONE features.

Creating an App

Open App Creation Modal

Click the [Create] button in the top right of the app page.

Enter App Information

Enter the app information.

  • Name
  • Project Assignment: Choose whether to assign the app to a specific project. When enabled, you can specify the project.
  • Workspace Role: Select the role the app will have in its workspace. (e.g., Workspace Owner)
  • Tags (Optional): Metadata added for easy app management.

Obtain Client ID & Client Secret

When the app is created, a Client Secret is issued, which is used to authenticate and manage the app in API/CLI environments.

⚠️
The Client Secret is provided only once and must be downloaded immediately. It cannot be recovered later, so store it securely.

Client ID

  • A unique value that identifies the app, required for authentication when using SpaceONE API.
  • Provided in JSON format, including information such as app_id, client_secret, role_type, workspace_id, etc.

SpaceONE CLI (spacectl)

  • A file that configures resource management using spacectl, SpaceONE’s CLI tool.
  • Contains a token value that can be used to authenticate API requests.
  • Includes endpoints information for connecting to SpaceONE’s gRPC API.
Reissuing Client Secret
To reissue a Client Secret for a specific app, select the app from the list and click [Regenerate Client Secret] in the actions dropdown.

Enabling and Disabling Apps

Select the app from the list and click [Enable] or [Disable] in the actions dropdown.

Modifying and Deleting Apps

Select the app from the list and click [Edit] or [Delete] in the actions dropdown.

Viewing REST API and gRPC Information

At the bottom of the app page, you can view API endpoint information related to the app.
API requests can be made in two ways: REST and gRPC.

REST API

You can check the available SpaceONE REST API endpoints.
The provided endpoints are Swagger UI links, which you can click to view and test the API documentation.

gRPC

Endpoints and names for each service are provided in a table, where you can check the gRPC address for the required service.