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.
Step 1: 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
Step 2: Assigning 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
Step 3: 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