# Applications

Canonical page: https://docs.ovok.com/applications

An application is an OAuth client of your project: an id and a secret that your own software holds. Create one in the [Console](https://ovok.com/console?ref=docs) under **Applications**, in the project and environment you work in. The type you pick sets what its secret can do.

| Type | Its secret signs in as | Use it for |
| --- | --- | --- |
| [Default](#default) | Full access for the project's own; nothing for one you add | Your app's client id for user sign-ins |
| [Social login](#social-login) | Nothing | Google or Apple sign-in for your users |
| [Admin](#admin) | A project admin | Server-to-server calls with full access |
| [Manager](#manager) | A Signals manager | Running your Signals tenant |
| [Submitter](#submitter) | A Signals submitter | Posting readings to Signals |

A secret is shown in the Console, so keep it on your server. Never ship it in a browser or mobile app.

## Applications are for software [#applications-are-for-software]

An application type says what a piece of software may do, never who a person is. People sign in as themselves:

- **Your team** are the project's admins, added and removed on the Console's **Members** page. See [Invite a project admin](/invitations/team-members).
- **Your users** are the practitioners and patients of your app. They sign in through your app with its client id, and their [access policies](/access-policies) set what they may do.

## Default [#default]

The client id your app sends when its users sign in, by [password, TAN or another method](/authentication). Your app needs only the id, never the secret.

<Callout type="warn">The project's Default client secret has full access to your project's data. Never ship it in a browser or mobile app.</Callout>

Every project comes with a Default client, named after the project. Its membership of the project has no [access policy](/access-policies/policy-model#no-policy-is-not-least-privilege), and no access policy means full access. With its id and secret, as HTTP Basic or exchanged with `client_credentials`, a caller can read and write every FHIR resource of the project. Only client secrets are hidden from it: the FHIR API returns a `ClientApplication`'s `secret` and `retiringSecret` to project admins alone.

A Default client you add on the **Applications** page has no membership: its secret signs in as nothing.

## Social login [#social-login]

A default client with Google or Apple sign-ins set up. Each sign-in has an internal id your app sends, the provider's OAuth client id, and the provider (`google` or `apple`). Your users sign in, and they get their own sessions. Keep its secret on your server like any other.

## Admin [#admin]

A client with an admin membership of the project. Its id and secret sign in as the project admin and pass every access check, so it can call anything an admin can.

- **Authenticates with** its id and secret as HTTP Basic on routes that accept it, or exchanged for a token with `client_credentials` at `POST /oauth2/token`. See [Authenticate](/signals/standalone/get-started#authenticate-and-get-a-session-token) for both.
- **Use it only** when no narrower type fits. The Console asks you to confirm before it creates one.

## Manager [#manager]

A client that acts as Signals' manager through `/v1/signals/api`. Its access policy holds exactly the `signals_*` capabilities that role needs: every route except posting readings.

- **Authenticates with** its id and secret, as for an admin client. It never gets the admin bypass, so only its own capabilities count.
- **Needs** a project with its own Signals tenant. On the shared tenant, creating one answers `409`.
- **Details:** [App types](/signals/standalone#app-types) and [Signals route policies](/access-policies/signals).

## Submitter [#submitter]

A client that acts as Signals' submitter: it posts readings and reads patients. Use one for each gateway or service that sends readings.

- **Authenticates and needs** the same as a manager.
- **Capabilities:** the submitter rows in [Signals route policies](/access-policies/signals).

## Integration [#integration]

The API can also create an `integration` client, which the Console does not offer. It reads and writes the project's `Patient` and `Observation` resources and reads `DetectedIssue` and `Flag`, and reaches no Signals route.

## See also [#see-also]

- [Authentication](/authentication)
- [Access policies](/access-policies)
- [Get started with the Signals API](/signals/standalone/get-started)
