LoginHistory
サポートされているコール
describeSObjects()、query()、retrieve()
特別なアクセスルール
1 つの例外を除き、「ユーザの管理」権限を持つユーザのみがこのオブジェクトにアクセスできます。この例外は、API バージョン 37.0 以降では、すべてのユーザが各自のログイン履歴レコードを取得できるという点です。
項目
| 項目 | 詳細 |
|---|---|
| ApiType |
|
| APIVersion |
|
| Application |
|
| AuthenticationServiceId | |
| Browser |
|
| ClientVersion |
|
| CipherSuite |
|
| CountryIso |
|
| LoginGeoId |
|
| LoginTime |
|
| LoginType | |
| LoginUrl |
|
| NetworkId |
|
| OptionsIsGet |
|
| OptionsIsPost |
|
| Platform |
|
| SourceIp |
|
| Status |
|
| TlsProtocol | |
| UserId |
|
使用方法
すべての項目を絞り込めるわけではありません。絞り込みは、次の項目でのみ実行できます。
- 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###############' |