この文章は 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 説明現在のブラウザバージョンです。表示ラベルは [ブラウザ] です。
CipherSuite	型 picklist プロパティ Filter、Group、Nillable、Restricted picklist、Sort 説明ログインに使用される TLS Cipher Suite。値は、ハイフンを区切り文字にした OpenSSL スタイルの暗号化スイート名になります。詳細は、「OpenSSL Cryptography and SSL/TLS Toolkit」を参照してください。この項目は、API バージョン 37.0 以降で使用できます。
ClientVersion	型 string プロパティ Group、Nillable、Sort 説明 API クライアントのバージョン。表示ラベルは [クライアントのバージョン] です。
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 説明セッションへのアクセスに使用されるログインの種別。 `AppExchange` `Application` (ユーザ名とパスワードのログイン) `Certificate` (証明書ベースの認証) `ChatterCommunityPortalUnPwd` (Chatter コミュニティへのユーザ名とパスワードのログイン) `ChatterCommunityThirdPartySso` (Chatter コミュニティへのシングルサインオン) `EmployeeLoginToCommunity` (コミュニティへの内部ユーザ名とパスワードのログイン) `LightningLogin` `NetworksPortalApiOnly` (コミュニティへの API ログイン) `Oauth, Remote Access Client` (OAuth 1.0 認証) `Oauth2, Remote Access 2.0` (OAuth 2.0 認証) `Partner` (パートナーポータルへのユーザ名とパスワードのログイン) `PasswordlessLogin` (外部ユーザのパスワードなしのログイン) `Portal` (ポータルへのユーザ名とパスワードのログイン) `PrmPortalThirdPartySso` (パートナーリレーション管理 (PRM) ポータルへのシングルサインオン) `PortalThirdPartySso` (ポータルへのシングルサインオン) `PrmPortal` (PRM ポータルへのユーザ名とパスワードのログイン) `Saml` (SAML 1.1 ログイン) `SamlChatterNetworks` (コミュニティへの SAML ログイン) `SamlCspPortal` (カスタマーサービスポータル (CSP) への SAML ログイン) `SamlPrmPortal` (PRM ポータルへの SAML ログイン) `SamlSite` (サイトへの SAML ログイン) `Saml2` (SAML 2.0 ログイン) `SelfService` (セルフサービスポータルへのユーザ名とパスワードのログイン) `ThirdPartySso` (認証プロバイダログイン) 表示ラベルは [ログイン種別] です。
LoginUrl	型 string プロパティ Filter、Group、Nillable、Sort 説明ログイン要求の送信元の URL。表示ラベルは [ログイン URL] です。
NetworkId	型 reference プロパティ Filter、Group、Nillable、Sort 説明ユーザがログインしているコミュニティの ID。組織で Salesforce コミュニティが有効化されている場合、この項目は API バージョン 31.0 以降で使用できます。
OptionsIsGet	型 boolean プロパティ Filter 説明セッションログインに使用される HTTP メソッドは GET 要求です。
OptionsIsPost	型 boolean プロパティ Filter 説明セッションログインに使用される HTTP メソッドは POST 要求です。
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 TLS 1.3 Unknown この項目は、API バージョン 37.0 以降で使用できます。
UserId	型 reference プロパティ Filter、Group、Nillable、Sort 説明ログインユーザの ID。表示ラベルは [ユーザ ID] です。

使用方法

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

AuthenticationServiceId
CipherSuite
CountryIso
Id
LoginTime
LoginType
LoginUrl
NetworkId
OptionsIsGet
OptionsIsPost
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###############'`

Salesforce および Lightning プラットフォームのオブジェクトリファレンス

LoginHistory

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

特別なアクセスルール

項目

使用方法