次の方法で共有


appCredentialSignInActivities を一覧表示する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

アプリケーション資格情報の最近のアクティビティを含む appCredentialSignInActivity オブジェクトの一覧を取得します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) AuditLog.Read.All Directory.Read.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション AuditLog.Read.All Directory.Read.All

重要

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

  • レポート閲覧者
  • セキュリティ閲覧者
  • セキュリティ管理者

HTTP 要求

GET /reports/appCredentialSignInActivities

オプションのクエリ パラメーター

このメソッドは、応答のカスタマイズに役立つ OData クエリ パラメーターの $top$filter$orderby をサポートします。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文の appCredentialSignInActivity オブジェクトのコレクションを返します。

例 1: すべての appCredentialSignInActivities を一覧表示する

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/reports/appCredentialSignInActivities

応答

次の例は応答を示しています。

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

{
  "value": [
    {
      "appId": "f4d9654f-0305-4072-878c-8bf266dfe146",
      "appObjectId": "6920caa5-1cae-4bc8-bf59-9c0b8495d240",
      "credentialOrigin": "application",
      "expirationDate": "2021-04-01T21:36:48-8:00",
      "id": "ODNmNDUyOTYtZmI4Zi00YWFhLWEzOTktYWM1MTA4NGUwMmI3fGFwcGxpY2F0aW9u",
      "keyId": "83f45296-fb8f-4aaa-a399-ac51084e02b7",
      "keyType":"certificate",
      "keyUsage": "sign",
      "resourceId": "a89dc091-a671-4da4-9fcf-3ef06bdf3ac3",
      "servicePrincipalObjectId": "cf533854-9fb7-4c01-9c0e-f68922ada8b6",
      "signInActivity": {
        "lastSignInDateTime": "2021-03-18T00:00:00-8:00",
        "lastSignInRequestId": "guid1"
      }
    },
    {
      "appId": "09e9da93-c1e8-4000-8b96-1ea6a12acf72",
      "appObjectId": "2e9276ec-7895-41f0-b63c-4d1d94552362",
      "credentialOrigin": "servicePrincipal",
      "expirationDate": "2021-05-11T08:36:48-8:00",
      "id": "OGEzN2NmZWMtYjBhMS00Y2IxLWFjMDgtYzUyYjAzODM0ZjRhfHNlcnZpY2VQcmluY2lwYWw=",
      "keyId": "8a37cfec-b0a1-4cb1-ac08-c52b03834f4a",
      "keyType":"certificate",
      "keyUsage": "verify",
      "resourceId": "cde0ef8b-9c88-473f-89c9-91eebafdec8b",
      "servicePrincipalObjectId": "afb9dcdc-34ef-4d8e-91b5-4f094758100c",
      "signInActivity": {
        "lastSignInDateTime": "2021-02-01T01:23:46-8:00",
        "lastSignInRequestId": "guid2"
      }
    }
  ]
}

例 2: keyId で資格情報の appCredentialSignInActivitiy を取得する

次の例は、keyId でフィルター処理された appCredentialSignInActivity オブジェクトを取得する方法を示しています。

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/reports/appCredentialSignInActivities?$filter=keyId eq '83f45296-fb8f-4aaa-a399-ac51084e02b7'

応答

次の例は応答を示しています。

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

{
  "@odata.type": "#microsoft.graph.appCredentialSignInActivity",
  "appId": "f4d9654f-0305-4072-878c-8bf266dfe146",
  "appObjectId": "6920caa5-1cae-4bc8-bf59-9c0b8495d240",
  "credentialOrigin": "application",
  "expirationDate": "2021-04-01T21:36:48-8:00",
  "id": "ODNmNDUyOTYtZmI4Zi00YWFhLWEzOTktYWM1MTA4NGUwMmI3fGFwcGxpY2F0aW9u",
  "keyId": "83f45296-fb8f-4aaa-a399-ac51084e02b7",
  "keyType":"secret",
  "keyUsage": "sign",
  "resourceId": "a89dc091-a671-4da4-9fcf-3ef06bdf3ac3",
  "servicePrincipalObjectId": "cf533854-9fb7-4c01-9c0e-f68922ada8b6",
  "signInActivity": {
    "lastSignInDateTime": "2021-04-01T00:00:00-8:00",
    "lastSignInRequestId": "b0a282a3-68ec-4ec8-aef0-290ed4350271"
  }
}

例 3: appId でアプリケーションの appCredentialSignInActivity を取得する

次の例は、appId でフィルター処理された appCredentialSignInActivity オブジェクトを取得する方法を示しています。

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/reports/appCredentialSignInActivities?$filter=appId eq 'f4d9654f-0305-4072-878c-8bf266dfe146'

応答

次の例は応答を示しています。

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

{
  "@odata.type": "#microsoft.graph.appCredentialSignInActivity",
  "appId": "f4d9654f-0305-4072-878c-8bf266dfe146",
  "credentialOrigin": "application",
  "expirationDate": "2021-04-01T21:36:48-8:00",
  "id": "ODNmNDUyOTYtZmI4Zi00YWFhLWEzOTktYWM1MTA4NGUwMmI3fGFwcGxpY2F0aW9u",
  "keyId": "83f45296-fb8f-4aaa-a399-ac51084e02b7",
  "keyType":"secret",
  "keyUsage": "sign",
  "resourceId": "a89dc091-a671-4da4-9fcf-3ef06bdf3ac3",
  "signInActivity": {
    "lastSignInDateTime": "2021-04-01T00:00:00-8:00",
    "lastSignInRequestId": "guid1"
  }
}