Поделиться через

Получение sslCertificate

  • Статья

Пространство имен: microsoft.graph.security

Примечание.

Для microsoft API Graph для Аналитика угроз Microsoft Defender требуется активная лицензия на портал аналитики угроз в Defender и лицензия на надстройку API для клиента.

Получение свойств и связей объекта sslCertificate .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ❌ ❌ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) ThreatIntelligence.Read.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение ThreatIntelligence.Read.All Недоступно.

HTTP-запрос

GET /security/threatIntelligence/sslCertificates/{sslCertificateId}

Необязательные параметры запросов

Этот метод поддерживает $countпараметры запроса OData , $select$search, $orderBy, , $skipи $top для настройки ответа. Общие сведения см. в статье Параметры запроса OData.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и объект microsoft.graph.security.sslCertificate в теле отклика.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/security/threatIntelligence/sslCertificates/ZmI5NjU1MTUwNWYxZWRiMjRkZDNiMzZmY2ZmZGI3NjU4MzNiODExOA==

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "value": {
    "id": "ZmI5NjU1MTUwNWYxZWRiMjRkZDNiMzZmY2ZmZGI3NjU4MzNiODExOA==",
    "firstSeenDateTime": "2023-03-10T01:20:47.000Z",
    "lastSeenDateTime": "2023-04-02T00:00:00.000Z",
    "fingerprint": "fb:96:55:15:05:f1:ed:b2:4d:d3:b3:6f:cf:fd:b7:65:83:3b:81:18",
    "sslVersion": "3",
    "expirationDateTime": "2024-03-03T18:56:17.000Z",
    "issueDateTime": "2023-03-09T18:56:17.000Z",
    "sha1": "fb96551505f1edb24dd3b36fcffdb765833b8118",
    "serialNumber": "1137389559885717770175191329273386705719099773",
    "subject": {
      "commonName": "microsoft.com",
      "address": {
        "city": "Redmond",
        "countryOrRegion": "US",
        "postalCode": null,
        "postOfficeBox": null,
        "state": "WA",
        "street": null
      },
      "email": null,
      "givenName": null,
      "organizationName": "Microsoft Corporation",
      "organizationUnitName": null,
      "serialNumber": null,
      "surname": null,
      "alternateName": [
        "pymes.microsoft.com",
        "mac2.microsoft.com",
        "sponsors.microsoft.com",
        "oemcommunity.microsoft.com",
        "gigjam.microsoft.com",
        "businesscentral.microsoft.com"
      ]
    },
    "issuer": {
      "commonName": "Microsoft Azure TLS Issuing CA 05",
      "address": {
        "city": null,
        "countryOrRegion": "US",
        "postalCode": null,
        "postOfficeBox": null,
        "state": null,
        "street": null
      },
      "email": null,
      "givenName": null,
      "organizationName": "Microsoft Corporation",
      "organizationUnitName": null,
      "serialNumber": null,
      "surname": null,
      "alternateName": []
    }
  }
}