To onboard a new Azure account into Data Theorem's API security product and grant access to your configuration, you need to create a new Azure AD (Active Directory) application.
This Azure AD application will allow our service to list (with limited read access) your configuration in order to discover resources and APIs.
Creating the Azure AD application
To create this new Azure AD application, open a new tab and:
- Login into your Azure Account through the Azure Portal
- Navigate to the Azure Active Directory page
- Select App registrations
- Select New application registration
- For the Name field enter
- DataTheorem
- For the Application type field select Web app
- For the Sign-on URL field enter
- https://securetheorem.com/
- Click Create
Assign the reader role to the Azure AD application
Now that we have a new Azure AD application we need to assign read-only access.
- Navigate to the All services page
- Select Subscriptions
- Select the subscription that corresponds to the environment that you want to give Data Theorem access to
- Select Access control (IAM)
- Select Add and from the dropdown select Add role assignment
- For the Role field select Reader
- For the Assign access to field select Azure AD user, group, or service principal
- For the Select field select the previously created App registration “DataTheorem”
- Click Save
Getting the Azure AD application credentials
After creating the read-only role we need to copy over the credentials so Data Theorem can access your environment. Once done you should have the following:
- Directory ID
- Application ID
- Authentication key (DO NOT share with anyone else)
Obtaining your Directory ID
- Navigate to the Azure Active Directory page
- Select Properties
- Copy out the Directory ID, this is also known as your Tenant ID
Obtaining your Application ID and Authentication key
- Navigate to the Azure Active Directory page
- Select App registrations
- Make sure you are viewing All apps and not just My apps
- Search for “DataTheorem”
- Select the app registration “Data Theorem”
- Copy out the Application ID
- Select Settings
- Select Keys
- Create a new Key by entering a new entry in the table
- For the Description field enter “apikey”
- For the Expires field select “Never expires”
- Click Save
- Copy out the generated Authentication key for the “DataTheorem” entry
Extra References
- How to: Use the portal to create an Azure AD application
- How to: Add app roles in your Azure AD application