mirror of
https://github.com/supabase/supabase.git
synced 2026-05-30 17:32:00 +08:00
69ce915a9e
This PR renames all `SUPABASE_PUBLISHABLE_OR_ANON_KEY` env vars into `SUPABASE_PUBLISHABLE_KEY` to make the new API keys default. This is in coordination with the rest of the docs. I've also cleaned up the `blocks/vue` package from unused files. <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Breaking Changes** * Public environment variable names renamed from PUBLISHABLE_OR_ANON_KEY → PUBLISHABLE_KEY across all framework integrations; update your environment configs. * **Documentation** * All framework guides, .env examples and registry docs updated to use the new variable names. * **Chores** * Cleaned up UI registry/templates: some example Vue registry items and autogenerated registry artifacts were removed or simplified. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
77 lines
3.1 KiB
Plaintext
77 lines
3.1 KiB
Plaintext
---
|
|
title: Password-based Authentication
|
|
description: Password-based authentication block for Vue Single Page Applications
|
|
---
|
|
|
|
<BlockPreview name="password-based-auth/auth/sign-up" />
|
|
|
|
## Installation
|
|
|
|
<BlockItem
|
|
name="password-based-auth-vue"
|
|
description="All needed components for the password based auth flow"
|
|
/>
|
|
|
|
## Folder structure
|
|
|
|
This block assumes that you have already installed a Supabase client for Vue from the previous step.
|
|
|
|
<RegistryBlock itemName="password-based-auth-vue" />
|
|
|
|
## Usage
|
|
|
|
Once you install the block in your Vue project, you'll get all the necessary components to set up a password-based authentication flow.
|
|
|
|
### Getting started
|
|
|
|
After installing the block, you'll have the following environment variables in your `.env.local` file:
|
|
|
|
```env
|
|
VITE_SUPABASE_URL=
|
|
VITE_SUPABASE_PUBLISHABLE_KEY=
|
|
```
|
|
|
|
- If you're using supabase.com, you can find these values in the [Connect modal](https://supabase.com/dashboard/project/_?showConnect=true&tab=frameworks&framework=vuejs&using=supabasejs) under App Frameworks or in your project's [API keys](https://supabase.com/dashboard/project/_/settings/api-keys).
|
|
|
|
- If you're using a local instance of Supabase, you can find these values by running `supabase start` or `supabase status` (if you already have it running).
|
|
|
|
### Setting up routes and redirect URLs
|
|
|
|
1. Set the site URL in the [URL Configuration](https://supabase.com/dashboard/project/_/auth/url-configuration) settings in the Supabase Dashboard.
|
|
1. Set up the route users will visit to reset or update their password. Go to the [URL Configuration](https://supabase.com/dashboard/project/_/auth/url-configuration) settings and add the `forgot-password` route to the list of Redirect URLs. It should look something like: `http://example.com/auth/forgot-password`.
|
|
1. Update the redirect paths in `login.vue` and `update-password.vue` components to point to the logged-in routes in your app. Our examples use `/protected`, but you can set this to whatever fits your app.
|
|
|
|
1. Add the following code in the authenticated route to redirect to login if the user is unauthenticated.
|
|
|
|
```vue
|
|
<script setup lang="ts">
|
|
import { onMounted } from 'vue'
|
|
|
|
import { createClient } from '@/lib/supabase/client'
|
|
|
|
onMounted(async () => {
|
|
const client = createClient()
|
|
|
|
const { error } = await client.auth.getUser()
|
|
|
|
if (error) {
|
|
location.href = '/login'
|
|
}
|
|
})
|
|
</script>
|
|
|
|
<template>
|
|
<div>Authenticated page</div>
|
|
</template>
|
|
```
|
|
|
|
Additionally, you could utilize the Navigation Guards from `vue-router` explained [here](https://router.vuejs.org/guide/advanced/navigation-guards#Global-Before-Guards).
|
|
|
|
## Further reading
|
|
|
|
- [Password-based authentication (implicit flow)](https://supabase.com/docs/guides/auth/passwords?queryGroups=flow&flow=implicit)
|
|
- [Authentication error codes](https://supabase.com/docs/guides/auth/debugging/error-codes)
|
|
- [Email templates](https://supabase.com/docs/guides/auth/auth-email-templates)
|
|
- [Email templates for local development](https://supabase.com/docs/guides/local-development/customizing-email-templates)
|
|
- [Custom SMTP](https://supabase.com/docs/guides/auth/auth-smtp)
|