ПРОВЕРЕННЫЕ УЧЕТНЫЕ ДАННЫЕ MICROSOFT ENTRA сетевой API

API сети Проверенные учетные данные Microsoft Entra позволяет выполнять поиск опубликованных учетных данных в сети Проверенные учетные данные Microsoft Entra.

Примечание.

Этот API предназначен для разработчиков, привычных к работе с интерфейсами API RESTful.

Базовый URL-адрес

API проверенной сети microsoft Entra ID обслуживается по протоколу HTTPS. Все URL-адреса, указанные в документации, имеют следующую базу: https://verifiedid.did.msidentity.com.

Проверка подлинности

API защищен с помощью идентификатора Microsoft Entra и использует маркеры носителя OAuth2. Регистрация приложения должна иметь разрешение API для Verifiable Credentials Service Admin, а при получении маркера доступа приложению нужно указать область 6a8b4b39-c021-437c-b060-5a14a3fd65f3/full_access.

Поиск издателей

Этот API используется для поиска издателей, доступных в сети Проверенные учетные данные Microsoft Entra. Вы можете искать издателей по имени связанного домена. Значение, предоставленное filter для параметра, будет использоваться для поиска издателей, которые подключены к Проверенные учетные данные Microsoft Entra и имеют проверенный связанный домен. В настоящее время поддерживается фильтрация только по linkeddomainurls с помощью оператора like. В ответе возвращается не более 15 издателей.

HTTP-запрос

GET /v1.0/verifiableCredentialsNetwork/authorities?filter=linkeddomainurls%20like%20Woodgrove

Заголовки запросов

Заголовок	Значение
Авторизация	Носитель (маркер). Обязательное поле
Тип контента	application/json

Параметры запроса

Параметр	значение
Фильтр	linkeddomainurls like Woodgrove

Возвращаемое сообщение

HTTP/1.1 200 OK
Content-type: application/json

[
  {
    "id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "did": "did:web:bank.woodgrove.com...<SNIP>...",
    "name": "WoodgroveBank",
    "linkedDomainUrls": [
      "https://bank.woodgrove.com/"
    ]
  },
  {
    "id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
    "tenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "did": "did:web:woodgrove.com...<SNIP>...",
    "name": "Woodgrove",
    "linkedDomainUrls": [
      "https://woodgrove.com/"
    ]
  }
]

Поиск опубликованных издателем типов учетных данных

Этот API используется для поиска опубликованных конкретным издателем типов учетных данных. Вам нужно знать издателей tenantId и issuerId. Возвращаемое сообщение содержит коллекцию опубликованных типов учетных данных с указанными в них утверждениями. В ответе возвращается не более 100 типов учетных данных.

HTTP-запрос

GET /v1.0/tenants/:tenantId/verifiableCredentialsNetwork/authorities/:issuerId/contracts/

Заголовки запросов

Заголовок	Значение
Авторизация	Носитель (маркер). Обязательное поле
Тип контента	application/json

Параметры запроса

Параметр	значение
tenantId	Идентификатор арендатора, полученный поиском по связанному доменному имени
issuerId	Идентификатор издателя, полученный поиском по связанному доменному имени

Возвращаемое сообщение

HTTP/1.1 200 OK
Content-type: application/json

[
  {
    "name": "Verified employee 1",
    "types": [
      "VerifiedEmployee"
    ],
    "claims": [
      "displayName",
      "givenName",
      "jobTitle",
      "preferredLanguage",
      "surname",
      "mail",
      "revocationId",
      "photo"
    ]
  }
]

Следующие шаги

Дополнительные сведения о Проверенные учетные данные Microsoft Entra Сети.