Skip to content

Commit

Permalink
Auth (#5336)
Browse files Browse the repository at this point in the history
## What are you changing in this pull request and why?

Auth docs

## Checklist
<!--
Uncomment when publishing docs for a prerelease version of dbt:
- [ ] Add versioning components, as described in [Versioning
Docs](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-entire-pages)
- [ ] Add a note to the prerelease version [Migration
Guide](https://github.com/dbt-labs/docs.getdbt.com/tree/current/website/docs/docs/dbt-versions/core-upgrade)
-->
- [ ] Review the [Content style
guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md)
so my content adheres to these guidelines.
- [ ] For [docs
versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#about-versioning),
review how to [version a whole
page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version)
and [version a block of
content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content).
- [ ] Add a checklist item for anything that needs to happen before this
PR is merged, such as "needs technical review" or "change base branch."

Adding or removing pages (delete if not applicable):
- [ ] Add/remove page in `website/sidebars.js`
- [ ] Provide a unique filename for new pages
- [ ] Add an entry for deleted pages in `website/vercel.json`
- [ ] Run link testing locally with `npm run build` to update the links
that point to deleted pages
  • Loading branch information
matthewshaver authored Apr 24, 2024
2 parents b88732c + dc8f65e commit 5df1b48
Show file tree
Hide file tree
Showing 6 changed files with 75 additions and 0 deletions.
75 changes: 75 additions & 0 deletions website/docs/docs/cloud/manage-access/mfa.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
title: "Multi-factor authentication"
description: "Configure dbt Cloud MFA"
id: "mfa"
sidebar: null
---

dbt Cloud provides multiple options for multi-factor authentication (MFA). MFA provides an additional layer of security on top of username and password. The available MFA methods are:
- SMS verification code
- Authenticator app
- Webauthn-compliant security key

## Configuration

You can only have one of the three MFA methods configured per user. These are enabled at the user level, not the account level.

1. Navigate to the **Account settings** and under **Your profile** click on **Password & Security**. Click **Enroll** next to the preferred method.

<Lightbox src="/img/docs/dbt-cloud/mfa-enrollment.png" title="Select MFA enrollment method" />

Choose the next steps based on your preferred enrollment selection:

<expandable alt_header="SMS verification code" >

2. Select your country code, enter your phone number in the field, and click **Continue**.

<Lightbox src="/img/docs/dbt-cloud/sms-enter-phone.png" title="Enter your phone number information" />

3. You will receive an SMS message with a six digit code. Enter the code in dbt Cloud.

<Lightbox src="/img/docs/dbt-cloud/enter-code.png" title="Enter the 6-digit code" />

</expandable>

<expandable alt_header="Authenticator app" >

2. Open your preferred authentication app (like Google Authenticator) and scan the QR code.

<Lightbox src="/img/docs/dbt-cloud/scan-qr.png" title="Scan the QR code" />

3. Enter the code provide for "dbt Labs: YOUR_EMAIL_ADDRESS" from your authenticator app into the the field in dbt Cloud.

</expandable>

<expandable alt_header="Webauthn-compliant security key" >

2. Follow the instructions in the modal window and click **Use security key**.

<Lightbox src="/img/docs/dbt-cloud/create-security-key.png" title="Scan the QR code" />

3. Scan the QR code or insert and touch activate your USB key to begin the process. Follow the on-screen prompts.

</expandable>

4. Store the backup passcode in a secure location. This key will be usefull if the MFA method fails (like a lost or broken phone).


## Disclaimer

The terms below apply to dbt Cloud’s MFA via SMS program, that dbt Labs (“dbt Labs”, “we”, or “us”) uses to facilitate auto sending of authorization codes to users via SMS for dbt Cloud log-in requests.

Any clients of dbt Labs that use dbt Cloud Labs 2FA via SMS program (after password is input) are subject to the dbt Labs privacy policy, the client warranty in TOU Section 5.1 second paragraph that Client's use will comply with the Documentation (or similar language in the negotiated service agreement between the parties) and these terms:

(1) The message frequency is a maximum of 1 message per user login;

(2) Message and data rates may apply;

(3) Carriers are not liable for delayed or undelivered messages;

(4) For help, please reply HELP to the SMS number from which you receive the log-in authorization code(s);

(5) To opt-out of future SMS messages, please reply STOP to the SMS number from which you receive the log-in authorization code(s). We encourage you to enable an alternate 2FA method before opting-out of SMS messages or you might not be able to log into your account.

Further questions can be submitted to [[email protected]](mailto:[email protected]).

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added website/static/img/docs/dbt-cloud/enter-code.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added website/static/img/docs/dbt-cloud/scan-qr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 5df1b48

Please sign in to comment.