この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

LoginHistory

組織と有効化したポータル内で発生した、成功または失敗したすべてのログインの履歴を表します。このオブジェクトは、API バージョン 21.0 以降で使用できます。

サポートされているコール

describeSObjects()query()retrieve()

特別なアクセスルール

1 つの例外を除き、「ユーザの管理」権限を持つユーザのみがこのオブジェクトにアクセスできます。この例外は、API バージョン 37.0 以降では、すべてのユーザが各自のログイン履歴レコードを取得できるという点です。

項目

項目 詳細
ApiType
string
プロパティ
Group、Nillable、Sort
説明
Soap Enterprise などの API 種別を示します。表示ラベルは [API 種別] です。
APIVersion
string
プロパティ
Group、Nillable、Sort
説明
クライアントが使用する API バージョンを表示します。表示ラベルは [API バージョン] です。
Application
string
プロパティ
Group、Nillable、Sort
説明
組織にアクセスするために使用するアプリケーション。表示ラベルは [アプリケーション] です。
AuthenticationServiceId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
ログインイベントの認証サービスの 18 文字の ID です。たとえば、この項目を使用して、ユーザのログインに使用された SAML または認証プロバイダ設定を識別できます。この項目は、API バージョン 34.0 以降で使用できます。表示ラベルは [認証サービス ID] です。
Browser
string
プロパティ
Group、Nillable、Sort
説明
現在のブラウザバージョンです。表示ラベルは [ブラウザ] です。
ClientVersion
string
プロパティ
Group、Nillable、Sort
説明
API クライアントのバージョン。表示ラベルは [クライアントのバージョン] です。
CipherSuite
picklist
プロパティ
Filter、Group、Nillable、Restricted picklist、Sort
説明
ログインに使用される TLS 暗号化スイート。値は、ハイフンを区切り文字にした OpenSSL スタイルの暗号化スイート名になります。詳細は、「OpenSSL Cryptography and SSL/TLS Toolkit」を参照してください。この項目は、API バージョン 37.0 以降で使用できます。
CountryIso
string
プロパティ
Filter、Group、Nillable、Sort
説明
ユーザの IP アドレスが物理的に存在する国の ISO 3166 コード。詳細は、「国コード - ISO 3166」を参照してください。この項目は、API バージョン 37.0 以降で使用できます。
LoginGeoId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
成功または失敗したログインイベントについて、ユーザの地理的な場所のレコードの 18 文字の ID。地理位置情報技術の性質上、地理位置情報項目の精度 (国、市区郡、郵便番号など) は変化する場合があります。この項目は、API バージョン 34.0 以降で使用できます。
LoginTime
dateTime
プロパティ
Filter、Nillable、Sort
説明
タイムゾーンは、GMT で表されます。表示ラベルは [ログイン時刻] です。
LoginType
picklist
プロパティ
Filter、Group、Restricted picklist、Sort
説明
ログイン種別 (Application、OAuth、SAML など)。表示ラベルは [ログイン種別] です。
LoginUrl
string
プロパティ
Filter、Group、Nillable、Sort
説明
ログイン要求の送信元の URL。表示ラベルは [ログイン URL] です。
NetworkId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
ユーザがログインしているコミュニティ の ID。組織で Salesforce コミュニティが有効化されている場合、この項目は API バージョン 31.0 以降で使用できます。
Platform
string
プロパティ
Group、Nillable、Sort
説明
ログインマシンのオペレーティングシステム。表示ラベルは [プラットフォーム] です。
SourceIp
string
プロパティ
Group、Nillable、Sort
説明
ログイン要求を送信したマシンの IP アドレス。API バージョン 23.0 以降では IPv4 または IPv6 アドレスです。API バージョン 22.0 以前では IPv4 アドレスで、IPv6 アドレスは null になります。表示ラベルは [アクセス元 IP] です。
Status
string
プロパティ
Group、Nillable、Sort
説明
試行ログインの状況を表示します。状況は、成功または失敗の理由です。表示ラベルは [状況] です。
TlsProtocol
picklist
プロパティ
Filter、Group、Nillable、Restricted picklist、Sort
説明
ログインに使用される TLS プロトコル。値は次のとおりです。
  • TLS 1.0
  • TLS 1.1
  • TLS 1.2
  • Unknown
この項目は、API バージョン 37.0 以降で使用できます。
UserId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
ログインユーザの ID。表示ラベルは [ユーザ ID] です。

使用方法

すべての項目を絞り込めるわけではありません。絞り込みは、次の項目でのみ実行できます。

  • AuthenticationServiceId
  • CipherSuite
  • CountryIso
  • Id
  • LoginTime
  • LoginType
  • LoginUrl
  • NetworkId
  • TlsProtocol
  • UserId

API によって、多くの強力なクエリを実行できます。次は、その例です。

クエリ例 クエリ文字列
各ユーザの UserId と LoginTime を示す簡単なクエリ SELECT UserId, LoginTime from LoginHistory;
特定の日時以降のログインのみを示すクエリ SELECT UserId, LoginTime from LoginHistory WHERE LoginTime > 2010-09-20T22:16:30.000Z;
特定の期間のログインを示すクエリ SELECT UserId, LoginTime from LoginHistory WHERE LoginTime > 2010-09-20T22:16:30.000Z AND LoginTime < 2010-09-21T22:16:30.000Z;
SAML ログインイベントの認証サービスを示すクエリ。Id=AuthenticationServiceId は LoginHistory に基づきます。 SELECT name, issuer, samlVersion FROM SamlSsoConfig WHERE Id = '0LE###############'
認証プロバイダログインイベントの認証サービスを示すクエリ。Id=AuthenticationServiceId は LoginHistory に基づきます。 SELECT Type, DeveloperName FROM AuthProvider WHERE Id = '0SO###############'