cloud-login
Log in to a Fauna account.
Description
The cloud-login
command prompts for Fauna credentials and,
if authentication is successful, creates a cloud
endpoint in the
configuration file, which is used
to query a Fauna database.
Command line prompts help create endpoints that work with Region Groups and with secrets for existing databases:
Prompt | Description | ||||
---|---|---|---|---|---|
Endpoint alias prefix |
To access databases in multiple Region Groups, this prompt requests a prefix that can be applied to multiple Region Group endpoints. |
||||
How do you prefer to authenticate? |
Authentication preference:
|
||||
Multi-factor authentication |
When multi-factor authentication (MFA) is enabled for your account,
you’re prompted for the current, time-based multi-factor authentication code.
Get the current code in your authenticator app. If you enter an incorrect
code, |
||||
Default endpoint |
When the configuration file has an existing endpoint, you are asked if the new endpoint to be created by this command should be the default endpoint. |
The cloud-login
command is the preferred way to connect to an endpoint.
Use the endpoint add
command
if you want to connect to a non-standard endpoint.
Examples
The following example demonstrates the use of cloud-login
and the
prompts for email/secret and password:
fauna cloud-login
? The endpoint alias prefix (to combine with a region): cloud
? How do you prefer to authenticate? Email and Password
? Email address: docs@fauna.com
? Password: [hidden]
? Enter your multi-factor authentication code 377277
? Endpoints created. Would you like to set one of them as default? Keep 'cloud'
endpoint as default
Endpoint 'cloud' set as default endpoint.
After a successful login, your
configuration file now has a
cloud
endpoint that includes the secret to access your top-level
database. The configuration file should resemble:
fauna cloud-login
Is this article helpful?
Tell Fauna how the article can be improved:
Visit Fauna's forums
or email docs@fauna.com
Thank you for your feedback!