Authentication
User authentication
Every request on the cloud Tigris platform must be authenticated. To authenticate yourself using CLI, run the following command:
tigris login api.preview.tigrisdata.cloud
The command initiates login flow by opening authentication page in the browser.
First step is to enter organization name (can be found in the beta invitaion e-mail)
Enter organization name and click "Continue" button. You'll be redirected to OpenID Connect provider selection page. Tigris support "Google" and "GitHub" providers.
Once selected, you may be asked to login to your Google or GitHub account, if you are not logged in yet.
On successful authentication you'll see the following message in the browser:
Now you can close the page and switch back to the terminal, where you initiated the login flow.
In the terminal you'll see success message as well:
You are authenticated now and can start executing CLI commands against the Tigris instance.
Checking current authentication information
Curent authentication configuration can be checked by running:
tigris config show
The output would look like this:
token: <token value>
url: api.preview.tigrisdata.cloud
Please make sure to keep the token secure. Whoever possesses the token can execute any command on your name.
The token can be provided as authorization header to authenticate bare HTTP APIs:
Authorization: Bearer <token value>
Application credentials
To authenticate applications written using Tigris SDKs, credentials need to be created, by running:
tigris create application your_app_name "human readable description"
The output contains id and secret, which need to be set in the SDKs authentication configuration:
{
"id": "<client id>",
"name": "your_app_name",
"description": "human readable description",
"secret": "<client secret here>",
"created_at": 1663802082000,
"created_by": "github|3436058"
}
Please make sure to keep the client id and secret in a safe place.