Skip to content

[ODM-12835] Fixes after review #156

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
genestack-okunitsyn merged 2 commits into from
Sep 29, 2025
Merged

[ODM-12835] Fixes after review #156

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1234c29
[ODM-12835] Fixes after Mikhail Smazhevsky review
Sep 29, 2025
95893f9
[ODM-12835] Slightly better formatting
Sep 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 8 additions & 22 deletions docs/user-guide/doc-odm-user-guide/getting-access-token-azure.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Getting Access Token (Azure)

This guide explains how to authenticate against an API protected by Azure AD using a **Bearer token**.
This guide explains how to authenticate against the ODM API protected by Azure AD using a **Bearer token**.
We’ll walk through installing the Azure CLI, obtaining the token, and then passing it in request headers.

---
Expand All @@ -9,13 +9,13 @@ We’ll walk through installing the Azure CLI, obtaining the token, and then pas

Before starting, ensure you have the following:

1. **Azure CLI installed**
1. **Azure CLI installed**
Follow the official installation guide:
👉 [Install the Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli)

2. **ID required for login**

* **Application (Client) ID**: identifies the registered application you’re requesting a token for.
2. **Application ID required for login**
It identifies the registered application you're requesting a token for.
It is recommended to get this ID from your ODM Administrator.

---

Expand Down Expand Up @@ -55,9 +55,9 @@ This will return a long JWT string (the **Bearer token**), for example:

---

## 3. Use the Bearer Token in API Calls
## 3. Use the Bearer Token in ODM API Calls

Pass the token in the `Authorization` header when making API requests.
Pass the token in the `Authorization` header when making ODM API requests.
Here’s an example using `curl`:

```bash
Expand All @@ -67,11 +67,7 @@ curl -X GET \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"
```

Replace `<YOUR_ACCESS_TOKEN>` with the value returned from the previous step.

---

## 4. Example Response
Replace `<ODM_HOST>` with the actual ODM address, `<YOUR_ACCESS_TOKEN>` with the value returned from the previous step.

If authentication is successful, you’ll receive a valid JSON response from the API. Example:

Expand All @@ -88,13 +84,3 @@ If authentication is successful, you’ll receive a valid JSON response from the
"data": []
}
```

---

## Summary

1. **Install Azure CLI** from the [official guide](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli).
2. Have your **Application (Client) ID** ready.
3. **Login** with `az login --scope api://<APPLICATION_ID>/default`.
4. **Get token** using `az account get-access-token --scope api://<APPLICATION_ID>/default`.
5. **Send requests** with `Authorization: Bearer <token>` header.