> For the complete documentation index, see [llms.txt](https://salte-auth.gitbook.io/salte-auth/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://salte-auth.gitbook.io/salte-auth/usage/getting-started.md).

# Getting Started

🎉 Huzzah! So you've decided to take the plunge into the wonderful world of Authentication!

This guide will attempt to quickly walk you through how you can utilize Salte Auth for authentication.

## Picking a Provider

### What is a Provider?

A `Provider` (Identity Provider) tells Salte Auth *who* you're going to be authenticating with.

For a list of examples you should check out the [providers](/salte-auth/usage/providers.md) page!.

### 😱 Which Provider should I use?!?

That primarily depends on where your priorities are.

#### I need all the features!

If you're worried about SSO (Single Sign-On) then an OpenID Connect Provider like [Auth0](https://github.com/salte-auth/auth0), [Azure](https://github.com/salte-auth/azure), etc. are probably your best bet.

#### I'm not made of money!

If cost is more of a concern I'd recommend using one of the OAuth2 Providers like [GitHub](https://github.com/salte-auth/github), [Google](https://github.com/salte-auth/google), [Facebook](https://github.com/salte-auth/facebook), etc.

## Picking a Handler

### What is a Handler?

A `Handler` tells Salte Auth *how* you're going to be authenticating.

For a list of examples you should check out the [handlers](/salte-auth/usage/handlers.md) page!.

## Setting up Salte Auth

### Install

```bash
# Install the Core
$ npm install @salte-auth/salte-auth
# Install a Provider
$ npm install @salte-auth/auth0
# Install a Handler
$ npm install @salte-auth/redirect
```

### Usage

```javascript
import { SalteAuth } from '@salte-auth/salte-auth';
import { Auth0 } from '@salte-auth/auth0';
import { Redirect } from '@salte-auth/redirect';

// Configure SalteAuth with Auth0's url and client id.
const auth = new SalteAuth({
  providers: [
    new Auth0({
      url: 'https://salte-os.auth0.com',
      clientID: '9JTBXBREtckkFHTxTNBceewrnn7NeDd0',

      routes: true
    })
  ],

  handlers: [
    new Redirect({
      default: true
    })
  ]
});
```

### Examples

Checkout our [examples repository](https://github.com/salte-auth/examples) for a collection of examples in a variety of frameworks!


---

# 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:

```
GET https://salte-auth.gitbook.io/salte-auth/usage/getting-started.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.