# auth

The authentication service and parameters. For example:

```
{
    "auth": {
        "service": "appmixer:google",
        "scope": [
            "https://mail.google.com/",
            "https://www.googleapis.com/auth/gmail.compose",
            "https://www.googleapis.com/auth/gmail.send"
        ]
    }
}
```

The `auth.service` identifies the [authentication module](https://docs.appmixer.com/building-connectors/authentication) that will be used to authenticate the user to the service that the component uses. It must have the following format: **\[vendor]:\[service]**. The Appmixer engine looks up the `auth.js` file under that vendor and service category. `auth.scope` provides additional parameters to the authentication module. See the Authentication section for more details.

When `auth` is defined, the component will have a section in the Designer UI inspector requiring the user to select from existing accounts or connect a new account. Only after an account is selected the user can continue configuring other properties of the component.

![Connected Accounts](https://content.gitbook.com/content/gA9J5A1N66u2GrNSZK7X/blobs/Juir3hEazymJ0G9nuf4Z/Screenshot%202019-03-14%20at%2015.25.22.png)
