This tool let's you, a developer, create request for AAD Graph API, issue the request and get the response. The responses can be viewed in a table format (instead of raw JSON) which makes visualization easier, although only simple non-null values are exposed in the table. The requests can be saved as templates that can be opened up later, and issued against different tenants. Finally, it also has a filter query builder that can let you compose a search for users, convert it into a filter query string that can be issued as a request.
To get started:
- Create an application in Azure Active Directory (https://manage.windowsazure.com), and give it at least the Directory Read permissions.
a. Create a web application if you want to store the key and authentication to not require manual entry of credentials. Such an application cannot access all properties (e.g. oauth2PermissionGrants), or perform certain operations (e.g. delete a user).
b. If you need to perform those operations, create a native application. You will be required to provide user credentials on every authentication, but it will allow administrator operations.
-
Click on the "Releases" tab in this GIT repository (at the top), and download the latest release.
-
Execute the AadGraphHelper.exe from the downloaded zip file.
-
In the tool, select Environment as "Production" and click "Add" in the Tenant/Credential list.
-
Add the credentials for the application that you created in step 1.
-
Click on the "Get Token" button.
-
Now you can select the method e.g. GET), resource (e.g. users) and click "Execute" button. This will issue the very first request. Once it executes successfully, play around and have fun.