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

LoginHistory

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

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

describeSObjects()、query()、retrieve()

API バージョン 42.0 以降では delete() を有効にすることもできます。「項目履歴および項目履歴アーカイブの削除の有効化」を参照してください。

特別なアクセスルール

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 説明組織にアクセスするために使用するアプリケーション。表示ラベルは [アプリケーション] です。
AuthMethodReference	型 string プロパティ Filter、Group、Nillable、Sort 説明 OpenID Connect シングルサインオンプロトコルに対してサードパーティの ID プロバイダーが使用する認証方法です。この項目は、API バージョン 51.0 以降で使用できます。表示ラベルは [認証メソッド参照] です。
AuthenticationServiceId	型 reference プロパティ Filter、Group、Nillable、Sort 説明ログインイベントの認証サービスの 18 文字の ID です。たとえば、この項目を使用して、ユーザーのログインに使用された SAML または認証プロバイダー設定を識別できます。この項目は、API バージョ�� 34.0 以降で使用できます。表示ラベルは [認証サービス ID] です。この項目は多態的なリレーション項目です。リレーション名 AuthenticationService リレーション種別 Lookup 参照先 AuthProvider、SamlSsoConfig
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 以降で使用できます。この項目はリレーション項目です。リレーション名 LoginGeo リレーション種別 Lookup 参照先 LoginGeo
LoginSubType	型 picklist プロパティ Filter、Group、Nillable、Restricted picklist、Sort 説明使用するログインフローの種別。 `OauthClientCredential` – `OAuth クライアントログイン情報` `OauthHybridUserAgent` – `ハイブリッドアプリケーションの OAuth ユーザー-エージェント` `OauthHybridWebServer` – `ハイブリッドアプリケーション用 OAuth Web サーバー` `OauthUserAgent` – `OAuth ユーザー-エージェント` `OauthUserAgentIdToken` – `ID トークンがある OAuth ユーザー-エージェント` `OauthUsernamePassword` – `OAuth ユーザー名-パスワード` `UsernamePasswordUiLogin` – `UI ユーザー名-パスワード` `OauthWebServer` – `OAuth Web サーバー` 表示ラベルは [ログインサブ種別] です。
LoginTime	型 dateTime プロパティ Filter、Sort 説明タイムゾーンは、GMT で表されます。表示ラベルは [ログイン時刻] です。
LoginType	型 picklist プロパティ Filter、Group、Restricted picklist、Sort 説明セッションへのアクセスに使用されるログインの種別。 `AppExchange` – `AppExchange` `Application` – `アプリケーション` `Certificate` – `証明書ベースのログイン` `ChatterCommunityPortalUnPwd` – `Chatter コミュニティの外部ユーザー` `ChatterCommunityThirdPartySso` – `Chatter コミュニティの外部ユーザーのサードパーティ SSO` `EmployeeLoginToCommunity` – `コミュニティへの従業員のログイン` `LightningLogin` – `Lightning Login` `NetworksPortalApiOnly` – `ネットワークポータル API のみ` `Oauth, Remote Access Client` – `リモートアクセスクライアント` `Oauth2, Remote Access 2.0` – `Remote Access 2.0` `OtherApi` – `その他の Apex API` `Partner` – `パートナー製品` `PasswordlessLogin` – `パスワードなしのログイン` `Portal` – `カスタマーサービスポータル` `PrmPortalThirdPartySso` – `パートナーポータルのサードパーティの SSO` `PrmPortal` – `パートナーポータル` `Saml` – `SAML Idp Initiated SSO` `SamlChatterNetworks` – `SAML Chatter コミュニティの外部ユーザー SSO` `SamlCspPortal` – `SAML カスタマーサービスポータル SSO` `SamlPrmPortal` – `SAML パートナーポータル SSO` `SamlSite` – `SAML サイトの SSO` `Saml2` – `SAML Sfdc Initiated SSO` `SelfService` – `SelfService` `ThirdPartySso` – `サードパーティの SSO` 表示ラベルは [ログイン種別] です。
LoginUrl	型 string プロパティ Filter、Group、Nillable、Sort 説明ログイン要求の送信元の URL。表示ラベルは [ログイン URL] です。
NetworkId	型 reference プロパティ Filter、Group、Nillable、Sort 説明ユーザーがログインしている Experience Cloud サイトの ID。組織で Salesforce Experience Cloud サイトが有効化されている場合、この項目は API バージョン 31.0 以降で使用できます。
OptionsIsGet	型 boolean プロパティ Filter 説明セッションログインに使用される HTTP メソッドは GET 要求です。
OptionsIsPost	型 boolean プロパティ Filter 説明セッションログインに使用される HTTP メソッドは POST 要求です。
Platform	型 string プロパティ Group、Nillable、Sort 説明ログインマシンのオペレーティングシステム。表示ラベルは [プラットフォーム] です。
SourceIp	型 string プロパティ Filter、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 プラットフォームのオブジェクトリファレンス

LoginHistory

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

特別なアクセスルール

項目

使用方法