> For the complete documentation index, see [llms.txt](https://waap.docs.link11.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://waap.docs.link11.com/v2.18/product-walkthrough/settings/account.md).

# Account

Changing user settings

The Account Settings page allows you to manage your Reblaze user accounts.&#x20;

## **Tab: Your account details**

![Your account details](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LuRghgerfT6t9aVOOha%2F-Mb6pqPxhmkZ9Lm5_fSB%2F-Mbf7Xj7rdwV7FneLmnV%2FRBZDEVEVGENIYL%20_%20Account%202021-06-08%2012-51-43.png?alt=media\&token=0e8157ad-7e87-46e3-a300-b4b05e0a8d6d)

### Basic account settings

From this tab, you can reset your password, name, and phone number.&#x20;

### Settings for OTPs (One Time Passwords)

Reblaze uses 2FA (two factor authentication). There are several options for sending an OTP when you login:

* If only an email address is provided, the OTP will be sent via email.
* If a phone number is provided, the OTP will be sent over SMS message.
* As an alternative, you can also get a QR code for use in apps such as Google Authenticator (available for both [Android](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2) and [iPhone](https://itunes.apple.com/il/app/google-authenticator/id388497605)).&#x20;

### API Key

This tab also offers a personal API key, to be used in all requests to the Reblaze API.

## Tab: Users management

![Users management](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LuRghgerfT6t9aVOOha%2F-Mb6pqPxhmkZ9Lm5_fSB%2F-MbfCXEOFboiXbjOOm8l%2FRBZDEVEVGENIYL%20_%20Account%202021-06-08%2013-38-45.png?alt=media\&token=a2c9a200-b5c3-4d70-9c7f-29c4e93ccd01)

This tab allows you to manage users that are attached to your organization. It is only available to users with administrator permissions.

### Administration

An admin can:

* Create a new user
* Edit an existing user
* Reset a user's password
* Delete a user

When a user account is being edited, this will appear:&#x20;

![Edit User](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LuRghgerfT6t9aVOOha%2F-Mb6pqPxhmkZ9Lm5_fSB%2F-MbfDPlAnfIyj53tU67g%2FRBZDEVEVGENIYL%20_%20Account%202021-06-08%2013-42-12.png?alt=media\&token=2cca70c4-6b19-4dc9-8c12-a70778261408)

The available Access Levels are:

* *Viewer*: can see the [Traffic](/v2.18/product-walkthrough/reblaze-traffic.md) section, i.e. the Dashboard and View Log.
* *Editor*: has all Viewer permissions, and can also configure security rulesets and policies in the [Security](/v2.18/product-walkthrough/security.md) and [Settings](/v2.18/product-walkthrough/settings.md) sections.
* *Organization Admin*: has all Editor permissions, and can also manage users via the Users Management page.
* *Reblaze Admin*: has all Organization Admin permissions, and can also edit and view the Notes, Init and Run pages.

## **Tab: Single sign on configuration**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LuRghgerfT6t9aVOOha%2F-Mb6pqPxhmkZ9Lm5_fSB%2F-MbfPGiAkOTqtIEx7BkK%2FRBZDEVEVGENIYL%20_%20Account%202021-06-08%2014-31-44.png?alt=media\&token=bf7a5440-63d5-443c-9ca1-74d140924d2d)

This tab allows SSO to be configured so that users have the ability to log into Reblaze with their **Okta** or **Microsoft** accounts.

Configuration options will vary depending on the type of account.

### Set up Okta SSO

#### **1. Go to** [**Okta**](https://www.okta.com/)**, register and create an application:**

Go to `https://{YOUR ACCOUNT}-admin.okta.com/admin/apps/active`

Click `Add Application` → `Create New App`

Choose `Platform: Web`, `Sign on method: SAML 2.0`

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2F4vZARMZXtEOUyPwRYqoq%2FSetup-Okta-SSO-1.png?alt=media\&token=8b687e21-b181-4c56-9568-e17f0e4c057c)

#### **2. Name it, setup links and attributes:**

*Single sign on URL*:&#x20;

`RBZ_SSO_ASSERTION_URL` env var. Value should look like: `https://{CUSTOMER_DOMAIN}/sso/saml20/signon`.<br>

*Audience URI (SP Entity ID)*:&#x20;

`RBZ_SSO_AUDIENCE_URL` env var. Value should look like: `https://{CUSTOMER_DOMAIN}/sso/saml20/audience`<br>

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FmyE5deG5p56Dc7NnWpci%2FSetup-Okta-SSO-2.png?alt=media\&token=e3c6dfe8-8c47-4d42-963e-b37100202b0e)

*Attribute Statements:*<br>

emailaddress: `user.email`<br>

displayname: `user.firstName + " " + user.lastName`<br>

groups: `appuser.rbzgroups`

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2F6r4CW1fT2mNGaMv3ELhb%2FSetup-Okta-SSO-3.png?alt=media\&token=edfbeef6-bc11-43f6-8296-5d4a655391da)

#### **3. Custom User profile**

In order to pass Admin group ID we need to add custom attribute to the user groups.\
Directory > Profile Editor > Apps > Click on Profile<br>

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FaLS5b6emjttLRAIJjDpn%2FSetup-Okta-SSO-4.png?alt=media\&token=fa8da645-dba3-465d-a557-a2d11098a8f0)

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2Fs1BpUww0Z7imx1uCO6qv%2FSetup-Okta-SSO-5.png?alt=media\&token=f1424e2b-06b0-4a5e-bd78-c65eb363fb2c)

Next step will be to map it.&#x20;

Directory > Profile Editor > Apps > Click on Mappings

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FwoIEvhu8xWZcrqnI5Jmh%2FSetup-Okta-SSO-6.png?alt=media\&token=be293b16-90bd-479b-ba54-9fa1bfdc69ee)

**4. Assign the application to users**

Create user groups for two possible access levels: Admin and Read-Only access.&#x20;

Assign users to it. Group name is the string you need for `RBZSSOSAML2_ADMINGROUP` or place the group name into the Reblaze console SSO settings.

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FJJiKH3BpTkt9r6N3THxA%2FSetup-Okta-SSO-7.png?alt=media\&token=78a036f6-c3b5-43bd-a58a-1772c3ecde20)

And in your just-created Application settings:

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FaYA3NIbs4emmWKhQeDs8%2FSetup-Okta-SSO-8.png?alt=media\&token=c500158b-6a4a-459f-87f6-fea6ab11110d)

On the assignment step, a value will be required for the custom attribute which we configured before. For the admin group the value will be same as on `RBZSSOSAML2_ADMINGROUP`, while for the read-only group value it can be anything else.

#### **5. Get Metadata XML link:**

Add the **URL** to the XML metadata file to the `RBZ_SSO_META_URL` env var (and/or for Provider URL field in admin)\
The URL example: <https://vreagles.okta.com/app/exkl1t3p61ek810CP5d6/sso/saml/metadata><br>

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FetdU6zGI5AftnN3ab4Yb%2FSetup-Okta-SSO-9.png?alt=media\&token=5fb6b937-e44a-457e-b354-44139fa2d6b7)

\ <br>

#### **6. Where to get** `RBZ_SSO_IDP_ISSUER`**:**

Go to Applications, choose yours, `Sign On` tab, click on `View Setup Instructions`

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FipfR3gfH9a8PoQItWM5i%2FSetup-Okta-SSO-10.png?alt=media\&token=409a08b3-4aac-4d30-8fdb-213a10131490)

There you'll find Identity Provider Issuer:

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2F6l40KB8ztgfyPj5YDpsm%2FSetup-Okta-SSO-11.png?alt=media\&token=8a0a78f1-ce06-4bd2-88ec-1d061308a1a3)

### Set up Microsoft Azure SSO

**1. Go to** [**Azure Portal**](https://azure.microsoft.com/en-us/account/) **→** `Enterprise applications`

**2. Choose** `+ New Application` **→** `+ Create your own application`**:**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2Fryb8gj1bkomeGJEUVftZ%2FSetup-Microsoft-Azure-SSO-1.png?alt=media\&token=130c770b-2f5d-4d59-9e9c-21951aaac2dc)

**3. Choose option** `Integrate any other application you don't find in the gallery (Non-gallery)` **(this option will create SSO app):**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FHiF9pXWqrtVq5siT224S%2FSetup-Microsoft-Azure-SSO-2.png?alt=media\&token=4bcb26ae-e1e6-45e6-abc0-01c0d2c74d51)

**4. Go to** `Single sign-on` **section and choose** `SAML`**:**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FD9kPcjv2B9myTkTSuJpi%2FSetup-Microsoft-Azure-SSO-3.png?alt=media\&token=b0ed4275-9b81-4f4a-b70c-4b77b5a7a698)

**5. Set up appropriate links:**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FJOC3u7AMgw4J6Duclmbn%2FSetup-Microsoft-Azure-SSO-4.png?alt=media\&token=cbb95489-c2a4-4434-978a-8b0dd3fd8c8e)

`RBZ_SSO_IDP_ISSUER` should be provided by a customer and have to be unique for the customer’s SSO applications. The best option is to just use something like: `customer_domain.com?sso=123`. (the **IDP** **Issuer** field (in the console) should be identical to the **Identifier** field (in Azure)and should be inserted without "https\://")\
\
**6. Get Metadata XML link and add to** `RBZ_SSO_META_URL` **environment variable:**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2F5D13Y0POyAdm2XicbTvu%2FSetup-Microsoft-Azure-SSO-5.png?alt=media\&token=1afed719-21f4-4bdf-931a-3b69e85fcd02)

&#x20;**7. Setup** `user.groups` **in User Attributes & Claims, so it send all groups related to the user:**

\
Click on “+ **Add a group claim”,** choose:

* **All groups**
* Source attribute: **Group ID**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FNNeBSChASIY7iNSfnYky%2FSetup-Microsoft-Azure-SSO-6.png?alt=media\&token=b81ee71a-8ae3-46d6-b205-51770e5df7de)

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FA1l0Sn46X2iIlltp3N4I%2FSetup-Microsoft-Azure-SSO-7.png?alt=media\&token=3558632b-6df4-48c7-9d4e-4b0f6a47383a)

**8. Add a user as a member of the application:**

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FQ3SjgfXyqe9vpV1g7NGL%2FSetup-Microsoft-Azure-SSO-8.png?alt=media\&token=cc22158e-6874-4a23-8017-51d6fd31a7f0)

**9. Get admin group ID from Azure and put it into** `RBZ_SSO_ADMIN_GROUP` **environment variable:**\
Go to `Azure Active Directory` → `Groups`, create a group.

`Object ID` is the string you need for `RBZ_SSO_ADMIN_GROUP` or place the group ID into the Reblaze console SSO settings:

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FU6KsJF25fXVQfdW9Mb35%2FSetup-Microsoft-Azure-SSO-9.png?alt=media\&token=60ad1200-c226-4d3f-ad01-ca75a0740a46)

And assign a user to the group:

![](https://1443104804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYa27AYz47cZTEzJZB1vy%2Fuploads%2FpYC0L8Hx3LmogACphiYp%2FSetup-Microsoft-Azure-SSO-10.png?alt=media\&token=7d6024cb-5002-446c-98b9-33c1298ad667)

<br>
