Authentication

The authentication process.

Overview

Authentication encompasses the following processes:

• Forgot password - See the /app/forgot-password endpoint for more information
• Reset password - See the /app/reset-password endpoint for more information
• Sign-up - See the /app/signup endpoint for more information
• Sign-up activation - See the /app/signup endpoint for more information
• Log in - See the /app/login endpoint for more information

Pages related to these authentication processes should only be accessible when the API responses include the header X-Session-Status: auth.

HTTP/1.1 200 OK
...
X-Session-Status: auth
...

Authentication flow

Optional auth server

Backstack offers an optional auth server that can be used to authenticate your application users. It handles the login and registration process, along with password resetting.

https://auth.backstack.com?app_id=your-app-id

Once authenticated, the user is redirected to your configured callback page where you can initiate the session.

Related information

• Responses - Handling responses from the API.
• Sessions - Managing the current session.
• Form validation - How Bacalhau handles form validation.
• Errors - Understanding the API error feedback.