Skip to main content

LookupSourceTenantUser

Finds one user of a source tenant by exact user name or e-mail, to grant that user access to the tenant of the context.

Examples​

Find a user of a sibling tenant that permits this tenant:

octo-cli -c LookupSourceTenantUser -st "meshmakers" -id "alice@meshmakers.io"

Options​

ShortLongRequiredDescription
-st--sourceTenantIdyesSource tenant ID: a registry ancestor, or a tenant whose allow-list permits the tenant of the context
-id--identifieryesExact user name or exact e-mail of the user in the source tenant (case-insensitive, no wildcards)

Notes​

Prints sourceTenantId, userId, userName and displayName (never the e-mail). Pass userId and userName to CreateExternalTenantUserMapping.

Every negative case (tenant absent or not permitting, no exact match, several matches, shadow or locked user) gives the same answer 'No user found that can be granted access' and exit code -3.

Lookups are limited per caller and tenant (default 20 per 10 minutes); over the limit the answer names the wait time (HTTP 429, code SourceUserLookupRateLimited).

Needs UserManagement in the tenant of the context and an identity service with.