IRPCExtensionAuthentications.LoginWithExtensionAuthentication
Vault API / standard write session returns metadata structure version
Logs the caller in to an external system with encrypted credentials. Used by M-Files clients that encrypt the credentials above the transport layer; applications should call StoreExtensionAuthenticationCredentials over TLS instead.
| Service | Extension authentications MFiles.IRPCExtensionAuthentications |
|---|---|
| gRPC method | /MFiles.IRPCExtensionAuthentications/LoginWithExtensionAuthentication |
| HTTP (mf-http-grpc) | POST /grpc/v1/login-with-extension-authentication |
| Request | LoginWithExtensionAuthenticationRequest |
| Response | LoginWithExtensionAuthenticationResponse |
| Book and level | Vault API, standard |
| Kind | write |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | no |
| Returns metadata structure version | yes (in the mfiles-metadata-version-bin trailer) |
| Streaming | none (unary) |
Remarks
- Data that the server cannot decrypt fails with "The parameter is incorrect.".
Request: LoginWithExtensionAuthenticationRequest
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 |
|---|---|---|
target | string | The id of the target. |
ear_data_encrypted | bytes | The credentials, encrypted with the server's public key in a format internal to the M-Files clients. |
Response: LoginWithExtensionAuthenticationResponse
No fields.
Related methods
- StoreExtensionAuthenticationCredentials -- Logs the caller in to an external system by storing the caller's credentials for it.