Rownd
Search…
⌃K
Links

App credentials

Create a new app key for your snippet or SDK or to leverage the Rownd API.
When your code interacts with Rownd through an SDK, Javascript code snippet, or directly to our REST API, you'll need a set of credentials to authenticate your access to the Rownd platform. At Rownd, we call these "app keys" and "app secrets." Every application creates a default app key, but you can create as many additional keys as you want.
The app key is a publishable value, meaning it isn't intended to be private. You'll use an app key in all of your user-facing code, such as React or Vue apps, websites, mobile apps, etc.
Each app key has an associated app secret that will be visible to you only once. App secrets are private values, meaning you should limit the number of people who have access to them. You should also use care to ensure they are not included in publicly visible configuration files, mobile app binaries, website deployments, etc. They should exist only within your backend server environments.
You can revoke an app key and its associated secret at any time through the Rownd dashboard. Be careful, though! Revoking a key that's still in use will likely result in downtime for your app. Ensure you generate new app keys and update your deployments with them before revoking existing keys.

What's the difference?

App keys help identify your application, enable the retrieval of certain application metadata, and initiate authentication from web or mobile.
App secrets authenticate machine-to-machine communication with Rownd to retrieve and update any user profile, generate sign-in (magic) links for any user, and support other more sensitive/restricted functions.

Working with app keys

From the Rownd dashboard, select the application for which you want to generate an app key, then select Overview from the side nav and click on App keys from the sub nav.
App keys are located in the overview section

Creating a new app key

Click on the "Add app key" button on the right side of the screen. A new app key and secret are generated, then the Edit app key dialog is displayed, which contains the name of the app key, the key itself, and its associated secret.
The edit app key dialog
Be sure to copy and store the app secret in a safe location, since it will be shown only once! Opening the "edit app key" dialog again will show a masked version of the secret.
You can rename the app key to something that makes sense to you, then press update to save it.

Updating and deleting/revoking app keys

If you want to delete or edit your app key, click on the three dots beneath the action column on the right side of the app keys table.
The app keys table showing edit and delete options
From the resulting menu, select edit to modify the name of the key (the key and secrets are immutable). Select delete to permanently revoke the key. It will no longer work.