> For the complete documentation index, see [llms.txt](https://docs.euno.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.euno.ai/sources/business-intelligence/looker-integration/using-a-custom-looker-role.md).

# 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. Browse to the "admin" section in your Looker instance and find the "roles" menu item

<figure><img src="/files/1Ug4uolIeCFM6hDhVnCP" alt="" width="337"><figcaption><p>Looker: Admin Settings - Roles</p></figcaption></figure>

2. Click "New Model Set"

<figure><img src="/files/ynTOXg4EtLn5LrSBeG9I" 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="/files/mcnOoMISyMdfkba3cH3w" 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="/files/IMI3ZadbxrbOK7qUEUrm" 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="/files/PjSxXBCeEgOpMLpQRh6r" 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

`see_users` is required when **Observe users** or **Observe groups** are enabled in Euno (they are enabled by default). `see_system_activity` is required for source validation and usage observation.

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

<figure><img src="/files/kjXlwjyqN9SgzFI25Q9y" 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="/files/Aca4zOA9tX08fenemHzt" 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. Name the role `euno_role`, pick `euno_permission_set` and `euno_model_set`, and click "New Role"

<figure><img src="/files/3ddU1diaNlzW12PDlXbb" 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="/files/f0zLZE0TEO69T0cdb1rg" 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="/files/wz9q2OM9B5D46aKIfHbJ" alt=""><figcaption><p>Looker: Admin Settings - Users</p></figcaption></figure>

2. Click "Add Users"

<figure><img src="/files/SIbGJXuONZsoed09qyFd" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/c5v3l3J9yFoAeQdHVdAk" 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](/sources/business-intelligence/looker-integration.md#stage-1-create-a-looker-api-key-to-be-used-by-euno-to-access-lookers-api) and follow the steps there.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
