ccuffs/auth-iduffs

Biblioteca para autenticação de usuários utilizando o idUFFS.

v1.1.1 2021-06-25 17:48 UTC

This package is auto-updated.

Last update: 2021-09-25 18:35:33 UTC


README

logo.png
68747470733a2f2f696d672e736869656c64732e696f2f6d61696e74656e616e63652f7965732f323032313f7374796c653d666f722d7468652d6261646765 68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6363756666732f617574682d6964756666732f43493f6c6162656c3d4275696c64266c6f676f3d676974687562266c6f676f436f6c6f723d7768697465267374796c653d666f722d7468652d6261646765

auth-iduffs

Um pacote PHP para autenticação de usuários através do idUFFS da Universidade Federal da Fronteira Sul. Além de prover autenticação, ele oferece informações sobre o usuário autenticado, como nome completo, CPF, entre outros.

✨Features

  • Autenticação com o endpoint id.uffs.edu.br via HTTPS;
  • Não necessita de tokens ou autorizações de API;
  • Obtem informações sobre o usuário (nome, CPF, etc);

🚀 Utilização

1. Adicione o pacote ao seu projeto

Na pasta raiz do seu projeto PHP, rode:

composer require ccuffs/auth-iduffs

Todas as dependências serão instaladas.

2. Autenticando usuários

Para autenticar um usuário, você utilizará a classe AuthIdUFFS informando os valores user e password, que são o idUFFS e senha do usuário, respecitivamente.

As informações são passadas ao método login() através de um array associativo:

$auth = new CCUFFS\Auth\AuthIdUFFS();

$info = $auth->login([
    'user'     => 'meuIdUFFS',
    'password' => 'minhaSenha'
]);

Se as credenciais informadas forem válidas, o método login() retorna um objeto com as seguintes propriedades:

object(stdClass)
  public 'username' => string
  public 'uid' => string
  public 'email' => string
  public 'pessoa_id' => string
  public 'name' => string
  public 'cpf' => string
  public 'location' => string
  public 'token_id' => string 
  public 'authenticated' => boolean

Se as credenciais não forem válidas (usuário ou senha incorretos), o método login() retorna null.

👩‍💻 Desenvolvimento

Se você pretende criar features novas, corrigir bugs ou afins, siga o passo a passo abaixo.

Clone o repositório:

git clone https://github.com/ccuffs/auth-iduffs && cd auth-iduffs

Instale as dependências:

git clone https://github.com/ccuffs/auth-iduffs && cd auth-iduffs

Implemente o que for necessário e rode os testes:

./vendor/bin/pest

Um dos testes (de autenticação de usuário valido) necessita de um idUFFS e senha válidos. Você pode informar esses valores através das variáveis de ambiente AUTH_IDUFFS_TEST_USERNAME e AUTH_IDUFFS_TEST_PASSWORD, respectivamente.

Se essas variáveis de ambiente não forem informadas, somente um dos testes deve falhar. Os demais devem passar.

🤝 Contribua

Sua ajuda é muito bem-vinda, independente da forma! Confira o arquivo CONTRIBUTING.md para conhecer todas as formas de contribuir com o projeto. Por exemplo, sugerir uma nova funcionalidade, reportar um problema/bug, enviar um pull request, ou simplemente utilizar o projeto e comentar sua experiência.

🎫 Licença

Esse projeto é licenciado nos termos da licença open-source MIT e está disponível de graça.

🧬 Changelog

Veja todas as alterações desse projeto no arquivo CHANGELOG.md.