OAuth Applications
Table of Contents
- What is OAuth?
- Creating a new OAuth application
- Creating a new developer application
- Revoking user tokens
- Deleting an application
- Interacting with the API through OAuth
- Have more questions?
When creating an application that requires access to DNSimple or letting an external application request authorization to private details in a user’s DNSimple account without getting their password, you’ll need an OAuth token.
If you only need basic access to the API, a regular user or account token can be used instead.
What is OAuth?
OAuth 2 is a protocol that lets external applications request authorization to private details in a user’s DNSimple account without getting their password. This is preferred over Basic Authentication, because tokens can be revoked by users at any time.
Developers need to register their application before starting. A registered OAuth application is assigned a unique client ID and client secret. The client secret should not be shared.
Creating a new OAuth application
- Navigate to your account page.
- Click the OAuth Applications tab on the left side, then go to the Developer applications card.
Your applications are listed here. You create a new application, edit existing applications, or remove them.
Creating a new developer application
Click Add to add a new access token.
When you create a new application, you’ll need to provide a few details, including Application Name, a Homepage URL, and an Authorization Callback URL.
Adding an application description is optional.
After the app has successfully been created, you’ll be taken to the page with your new application, showing your Client ID and Client Secret.
Both the Client ID and Client Secret are unique to your application, and the client secret should not be shared.
Revoking user tokens
You can revoke all user tokens for your application by clicking Revoke.
This cannot be undone. All clients will lose access to your application.
Deleting an application
This action cannot be undone, and will permanently delete your application. Any clients using the application will no longer be able to access DNSimple.
To delete an application, click Delete.
When deleting an application, you’ll receive a warning prompt to ensure you want to continue.
Interacting with the API through OAuth
For more details and step-by-step instructions on how to interact with DNSimple’s API through OAuth, read this developer guide.
Have more questions?
If you have additional questions or need any assistance with your OAuth Applications, just contact support, and we’ll be happy to help.