IRPCVault.GetReportAccessCredentials

View as Markdown

Vault API / core read session idempotent returns metadata structure version

Gets the report access credentials for this vault. The credentials are encrypted with the provided public key.

ServiceVault information MFiles.IRPCVault
gRPC method/MFiles.IRPCVault/GetReportAccessCredentials
HTTP (mf-http-grpc)POST /grpc/v1/get-report-access-credentials
RequestGetReportAccessCredentialsRequest
ResponseGetReportAccessCredentialsResponse
Book and levelVault API, core
Kindread
SessionRequired: the session ID from LogIn in the mfiles-session-id-bin metadata.
Idempotentyes
Returns metadata structure versionyes (in the mfiles-metadata-version-bin trailer)
Streamingnone (unary)

Remarks

Used by M-Files reporting components. Requires a server license that includes reporting; otherwise fails with E_MFILES_NO_LICENSE_FOR_REPORTING. The credentials are encrypted with the caller's public key.

Request: GetReportAccessCredentialsRequest

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
public_keybytesThe public key as a BLOB for encrypting the credentials.

Response: GetReportAccessCredentialsResponse

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
pimpersonationImpersonationReceives the report access credentials (represented by Impersonation sturct).
pimpersonation.typeImpersonationTypeImpersonation type.Values: IMPERSONATION_TYPE_SYSTEM_ACCOUNT (0), IMPERSONATION_TYPE_LOCAL_WINDOWS_ACCOUNT (1), IMPERSONATION_TYPE_EXTERNAL_ACCOUNT (2).
pimpersonation.accountstringAccount name (e.g. DOMAIN\user).
pimpersonation.encrypted_passwordbytesEncrypted password.