IRPCExtensionAuthentications.GetExtensionAuthenticationStatus
Vault API / standard read session idempotent returns metadata structure version
Lists the targets for which the caller has stored credentials, with the account name used.
| Service | Extension authentications MFiles.IRPCExtensionAuthentications |
|---|---|
| gRPC method | /MFiles.IRPCExtensionAuthentications/GetExtensionAuthenticationStatus |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-extension-authentication-status |
| Request | GetExtensionAuthenticationStatusRequest |
| Response | GetExtensionAuthenticationStatusResponse |
| Book and level | Vault API, standard |
| Kind | read |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | yes (in the mfiles-metadata-version-bin trailer) |
| Streaming | none (unary) |
Remarks
- Requires a vault session. Returns only the caller's own entries.
- A target with no entry has no stored credentials for the caller.
Request: GetExtensionAuthenticationStatusRequest
No fields.
Response: GetExtensionAuthenticationStatusResponse
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
statuses[] | repeated ExtensionAuthenticationStatus | One entry per target with stored credentials. |
statuses[].user | int32 | The ID of the user account the credentials belong to. |
statuses[].user_type | ExtensionAuthenticationSpecialUserType | EXTENSION_AUTHENTICATION_SPECIAL_USER_TYPE_NORMAL for a user's own credentials, or the kind of vault-wide account.Values: EXTENSION_AUTHENTICATION_SPECIAL_USER_TYPE_NORMAL (0), EXTENSION_AUTHENTICATION_SPECIAL_USER_TYPE_COMMON (1), EXTENSION_AUTHENTICATION_SPECIAL_USER_TYPE_BACKGROUND (2), EXTENSION_AUTHENTICATION_SPECIAL_USER_TYPE_PERMISSIONS (3). |
statuses[].connection_name | string | The id of the target. |
statuses[].account | string | The account name on the external system. |
statuses[].is_missing | bool | True if no usable credentials are stored for this user and target. |