PHPackages                             ccuffs/auth-iduffs - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. ccuffs/auth-iduffs

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

ccuffs/auth-iduffs
==================

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

v1.1.1(4y ago)101.1k2[1 issues](https://github.com/ccuffs/auth-iduffs/issues)MITPHPPHP &gt;=7.1CI failing

Since Oct 27Pushed 4y ago2 watchersCompare

[ Source](https://github.com/ccuffs/auth-iduffs)[ Packagist](https://packagist.org/packages/ccuffs/auth-iduffs)[ RSS](/packages/ccuffs-auth-iduffs/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

 [![](.github/logo.png "Logo do projeto")](.github/logo.png)
 [![](https://camo.githubusercontent.com/ed4b076d510cfd99e26040f288521c15793782e370e031e4b7fb09fe985b29f8/68747470733a2f2f696d672e736869656c64732e696f2f6d61696e74656e616e63652f7965732f323032323f7374796c653d666f722d7468652d6261646765 "Status do projeto")](https://camo.githubusercontent.com/ed4b076d510cfd99e26040f288521c15793782e370e031e4b7fb09fe985b29f8/68747470733a2f2f696d672e736869656c64732e696f2f6d61696e74656e616e63652f7965732f323032323f7374796c653d666f722d7468652d6261646765) [![](https://camo.githubusercontent.com/88800a62b7f89cb1686aed1680ee51ba2573536a106e39c73dee53c5e324c9ed/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6363756666732f617574682d6964756666732f43493f6c6162656c3d4275696c64266c6f676f3d676974687562266c6f676f436f6c6f723d7768697465267374796c653d666f722d7468652d6261646765 "Build status")](https://camo.githubusercontent.com/88800a62b7f89cb1686aed1680ee51ba2573536a106e39c73dee53c5e324c9ed/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6363756666732f617574682d6964756666732f43493f6c6162656c3d4275696c64266c6f676f3d676974687562266c6f676f436f6c6f723d7768697465267374796c653d666f722d7468652d6261646765)

auth-iduffs
===========

[](#auth-iduffs)

Um pacote PHP para autenticação de usuários através do [idUFFS](https://id.uffs.edu.br) da [Universidade Federal da Fronteira Sul](https://www.uffs.edu.br). Além de prover autenticação, ele oferece informações sobre o usuário autenticado, como nome completo, CPF, entre outros.

✨Features
---------

[](#features)

- Autenticação com o endpoint [id.uffs.edu.br](https://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
------------

[](#-utilização)

### 1. Adicione o pacote ao seu projeto

[](#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

[](#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
-------------------

[](#‍-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
-----------

[](#-contribua)

Sua ajuda é muito bem-vinda, independente da forma! Confira o arquivo [CONTRIBUTING.md](CONTRIBUTING.md) para conhecer todas as formas de contribuir com o projeto. Por exemplo, [sugerir uma nova funcionalidade](https://github.com/ccuffs/auth-iduffs/issues/new?assignees=&labels=&template=feature_request.md&title=), [reportar um problema/bug](https://github.com/ccuffs/auth-iduffs/issues/new?assignees=&labels=bug&template=bug_report.md&title=), [enviar um pull request](https://github.com/ccuffs/hacktoberfest/blob/master/docs/tutorial-pull-request.md), ou simplemente utilizar o projeto e comentar sua experiência.

🎫 Licença
---------

[](#-licença)

Esse projeto é licenciado nos termos da licença open-source [MIT](https://choosealicense.com/licenses/mit) e está disponível de graça.

🧬 Changelog
-----------

[](#-changelog)

Veja todas as alterações desse projeto no arquivo [CHANGELOG.md](CHANGELOG.md).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~120 days

Total

3

Last Release

1785d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8f050ee8eb11afab6b5b800f25b535baa7452b6a5bb9178dca3f0f0a0d8c1467?d=identicon)[ComputacaoUFFS](/maintainers/ComputacaoUFFS)

---

Top Contributors

[![Dovyski](https://avatars.githubusercontent.com/u/512405?v=4)](https://github.com/Dovyski "Dovyski (23 commits)")[![mateusKoppe](https://avatars.githubusercontent.com/u/12251731?v=4)](https://github.com/mateusKoppe "mateusKoppe (5 commits)")

---

Tags

academicauthenticationcomposer-packagecomputer-sciencehacktoberfestphpphp7uffscomposerpackageauthacademiciduffsuffs

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/ccuffs-auth-iduffs/health.svg)

```
[![Health](https://phpackages.com/badges/ccuffs-auth-iduffs/health.svg)](https://phpackages.com/packages/ccuffs-auth-iduffs)
```

###  Alternatives

[lab404/laravel-impersonate

Laravel Impersonate is a plugin that allows to you to authenticate as your users.

2.3k16.4M48](/packages/lab404-laravel-impersonate)[rickycezar/laravel-jwt-impersonate

Laravel Impersonate is a plugin that allows to you to authenticate as your users.

24117.6k](/packages/rickycezar-laravel-jwt-impersonate)[hapidjus/laravel-impersonate-ui

UI for 404labfr/laravel-impersonate

371.5k](/packages/hapidjus-laravel-impersonate-ui)[windhoney/yii2-rest-rbac

RBAC Auth manager for Yii2 RESTful

811.2k](/packages/windhoney-yii2-rest-rbac)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
