# 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/6.0/5.2/component-definition/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://4257661311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpyTqJi517UiwFJJRydZ%2Fuploads%2Fgit-blob-ecafce761592ead43f0d5da407b835b195598e47%2FScreenshot%202019-03-14%20at%2015.25.22.png?alt=media)
