Alfeg Auth Developer

Documentação e exemplos de integração

API Docs

Início Rápido

1

Instalar SDK

Instale o SDK JavaScript via npm

npm install @alfeg/auth-sdk
2

Configurar

Inicialize o SDK com suas credenciais

const auth = new AlfegAuth({ authServerUrl: 'https://auth.alfeg.com.br', clientId: 'seu-client-id' });
3

Implementar Login

Adicione o botão de login na sua aplicação

<button onClick={() => auth.loginWithGoogle()}> Continuar com Google </button>
4

Proteger Rotas

Valide o token nas rotas protegidas

const user = await auth.getUser(); if (!user) { redirect('/login'); }

Endpoints de Teste (10 Passos)

1GET/api/health
Verificar Saúde do Auth Server

Confirmar que o servidor está rodando

curl -X GET https://auth.alfeg.com.br/api/health
2POST/api/auth/login
Login com Email/Senha

Obter JWT token para autenticação

curl -X POST https://auth.alfeg.com.br/api/auth/login -H "Content-Type: application/json" -d '{"email": "[email protected]", "password": "Teste@123"}'
3POST/api/auth/logout
Logout

Encerrar sessão e invalidar token

curl -X POST https://auth.alfeg.com.br/api/auth/logout -H "Authorization: Bearer $JWT_TOKEN" -H "Content-Type: application/json"
4POST/api/auth/api-keys
Criar API Key

Gerar chave de acesso para integração

curl -X POST https://auth.alfeg.com.br/api/auth/api-keys -H "Authorization: Bearer $JWT_TOKEN" -H "Content-Type: application/json" -d '{"name": "Test", "scopes": ["read:users"]}'
5GET/api/auth/api-keys
Listar API Keys

Obter todas as API Keys do usuário

curl -X GET https://auth.alfeg.com.br/api/auth/api-keys -H "Authorization: Bearer $JWT_TOKEN"
6DELETE/api/auth/api-keys/{id}
Deletar API Key

Remover uma API Key

curl -X DELETE https://auth.alfeg.com.br/api/auth/api-keys/1 -H "Authorization: Bearer $JWT_TOKEN"
7POST/api/auth/webhooks
Criar Webhook

Registrar endpoint para notificações

curl -X POST https://auth.alfeg.com.br/api/auth/webhooks -H "Authorization: Bearer $JWT_TOKEN" -H "Content-Type: application/json" -d '{"name": "Test", "url": "https://webhook.site/id", "events": ["user.created"]}'
8GET/api/auth/webhooks
Listar Webhooks

Obter todos os webhooks do usuário

curl -X GET https://auth.alfeg.com.br/api/auth/webhooks -H "Authorization: Bearer $JWT_TOKEN"
9POST/api/auth/webhooks/{id}/test
Testar Webhook

Enviar evento de teste para o webhook

curl -X POST https://auth.alfeg.com.br/api/auth/webhooks/1/test -H "Authorization: Bearer $JWT_TOKEN" -H "Content-Type: application/json"
10DELETE/api/auth/webhooks/{id}
Deletar Webhook

Remover um webhook

curl -X DELETE https://auth.alfeg.com.br/api/auth/webhooks/1 -H "Authorization: Bearer $JWT_TOKEN"

Exemplos de Código

React - Componente de Login

import { useEffect } from 'react';

export default function LoginPage() {
  const handleGoogleLogin = () => {
    window.location.href = 'https://auth.alfeg.com.br/api/auth/google';
  };

  return (
    <div className="login-container">
      <button onClick={handleGoogleLogin}>
        Continuar com Google
      </button>
    </div>
  );
}

Usando o SDK JavaScript

import { AlfegAuth } from '@alfeg/auth-sdk';

const auth = new AlfegAuth({
  authServerUrl: 'https://auth.alfeg.com.br',
  clientId: 'seu-client-id'
});

// Login com Google
auth.loginWithGoogle();

// Verificar autenticação
const user = await auth.getUser();
console.log(user);

// Logout
auth.logout();

Validar Token com Fetch

// Validar token no servidor
const response = await fetch(
  'https://auth.alfeg.com.br/api/validate/token',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${token}`
    }
  }
);

const result = await response.json();
if (result.valid) {
  console.log('Token válido:', result.user);
}

Next.js - Middleware de Autenticação

import { NextRequest, NextResponse } from 'next/server';

export async function middleware(request: NextRequest) {
  const token = request.cookies.get('auth_session')?.value;

  if (!token) {
    return NextResponse.redirect(
      new URL('https://auth.alfeg.com.br/login', request.url)
    );
  }

  return NextResponse.next();
}

export const config = {
  matcher: ['/dashboard/:path*']
};

Recursos Disponíveis

OAuth 2.0

Autenticação segura com Google, Facebook, GitHub e Apple

SDK JavaScript

Biblioteca npm pronta para usar em qualquer projeto

Documentação Completa

Guias, exemplos e referência de API detalhada

Pronto para começar?

Integre a autenticação Alfeg em seu sistema em minutos. Acesse a documentação completa da API e veja exemplos práticos.