# Using a custom Looker role

Some teams prefer to use custom [Looker roles](https://cloud.google.com/looker/docs/admin-panel-users-roles) to configure Euno's Looker integration. Consider using a custom Looker Role for Euno's Looker integration to:

1. Further lock down the permissions of Euno's Looker integration
2. Avoid breaking Euno's Looker integration when configuring permissions for other Looker users

## Setting up a Custom Role for Euno's Looker Integration

To set up a custom Looker Role for Euno's Looker integration complete the following:

1. Create a Looker Model Set
2. Create a Permission Set with the minimal permissions required
3. Create a Looker Role
4. Create a Looker User and associate it with the Looker Role

### Stage 1: Create a Looker Model Set

1. Browser to the "admin" section in your Looker instance and find the "roles" menu item

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-4b426582f21562677bb710a0931f40d0191a0fba%2Fimage%20(4)%20(1)%20(1)%20(1)%20(2)%20(1).png?alt=media" alt="" width="337"><figcaption><p>Looker: Admin Settings - Roles</p></figcaption></figure>

2. Click "New Model Set"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-dce58d09c236a3c491aa10ddb186cf661f2fed1c%2Fimage%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(2)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Looker: New Model Set</p></figcaption></figure>

3. Name the new Model Set `euno_model_set`. Do not check any of the LookML models. Euno's Looker integration does not require access to any LookML model.
4. Click "New Model Set" to save the new Model Set.

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-92cbd950093753a472f9b456d8f399d11945a0e2%2Fimage%20(2)%20(1)%20(1)%20(1)%20(2)%20(1)%20(1).png?alt=media" alt="" width="375"><figcaption><p>Looker: Save New Model Set</p></figcaption></figure>

5. Once saved, you'll be redirected back to the "Roles" screen. Verify that the model set was created by scrolling down to the "Model Sets" table. You should see the new Model Set there.

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-eca4260a79d0c31cb1dcd187eac909c4ace9a640%2Fimage%20(3)%20(1)%20(1)%20(1)%20(2)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Looker: Model Sets Table</p></figcaption></figure>

### Stage 2: Create a Permission Set

1. In the "Roles" screen, click "New Permission Set"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-0e51fbc7d85df727583a2a2f1beeb2165b72f995%2Fimage%20(4)%20(1)%20(1)%20(1)%20(2)%20(1)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

2. Name the new Permission Set `euno_permission_set` and check the following permissions:

* access\_data
* manage\_models
* see\_users
* see\_system\_activity

3. Click "New Permission Set" to save the new Permission Set

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-95339ba464c9a91aa49916dd3ac8ffb9d981ea20%2Fimage%20(5)%20(1)%20(1)%20(2)%20(1).png?alt=media" alt="" width="375"><figcaption><p>Looker: Save Permission Set</p></figcaption></figure>

4. Verify that the new Permission Set was created in the Permission Sets table in the "roles" screen.

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-5f5b7e0d2c8dfd5f24517aecb30b9f94a91267d8%2Fimage%20(6)%20(1)%20(1)%20(2)%20(1).png?alt=media" alt=""><figcaption><p>Looker: Permission Sets Table</p></figcaption></figure>

### Stage 3: Create a Looker Role

1. Back in the "roles" screen, Click "New Role"
2. Pick `euno_permission_set` and `euno_model_set` and click "New Role"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-382fe6460122380c66e57628eaf80ca2c3a2f33c%2Fimage%20(7)%20(1)%20(1)%20(2)%20(1).png?alt=media" alt=""><figcaption><p>Looker: Create a Looker Role</p></figcaption></figure>

3. Verify that the role is created in the "Roles" tables

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-f1fb44c6ec426363bb7c7384874cd3d480da7284%2Fimage%20(8)%20(1)%20(1)%20(2)%20(1).png?alt=media" alt="" width="127"><figcaption><p>Looker: Roles</p></figcaption></figure>

### Stage 4: Create a Looker User and assign it the Looker Role

1. Find the "Users" option in the "admin" sidebar

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-1aedfa29bfe57d2af66d5a0e959c6ff1b65ee600%2Fimage%20(10)%20(1)%20(1)%20(2).png?alt=media" alt=""><figcaption><p>Looker: Admin Settings - Users</p></figcaption></figure>

2. Click "Add Users"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-6443e3589515a77a01abcc4386403ca6da805571%2Fimage%20(11)%20(1)%20(1)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

2. Give the user an email address and assign the role `euno_role`, then click "Save"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-41aaa4f82d927d11a7382a314ede846624cbd78a%2Fimage%20(12)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Looker: Assigning Role to User</p></figcaption></figure>

You're done. Go back to [stage 1 in Setting up Euno's Looker Integration](https://docs.euno.ai/sources/business-intelligence/looker-integration/..#stage-1-create-a-looker-api-key-to-be-used-by-euno-to-access-lookers-api) and follow the steps there.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.euno.ai/sources/business-intelligence/looker-integration/using-a-custom-looker-role.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
