# passport-anonymous

> Anonymous authentication strategy for Passport.

Latest version **1.0.1** (published 2013-08-02) · 0 weekly downloads

## Install

```sh
npm install passport-anonymous
pnpm add passport-anonymous
yarn add passport-anonymous
bun add passport-anonymous
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2013-08-02 |
| First published | 2012-07-31 |
| Weekly downloads | 0 |
| TypeScript types | separate (@types/passport-anonymous) |
| Module format | CommonJS |
| Node | >= 0.4.0 |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Jared Hanson |
| Maintainers | jaredhanson |
| Keywords | passport, authn, authentication, anonymous |

## Links

- npm: https://www.npmjs.com/package/passport-anonymous
- Repository: https://github.com/jaredhanson/passport-anonymous
- Issues: http://github.com/jaredhanson/passport-anonymous/issues
- npm.io page: https://npm.io/package/passport-anonymous

## Dependencies (1)

- [passport-strategy](https://npm.io/package/passport-strategy.md) 1.x.x

## Recent versions

- 1.0.1 (latest) — 2013-08-02
- 1.0.0 — 2013-08-02
- 0.1.0 — 2012-07-31

## README

# passport-anonymous

[![Build](https://travis-ci.org/jaredhanson/passport-anonymous.png)](http://travis-ci.org/jaredhanson/passport-anonymous)
[![Coverage](https://coveralls.io/repos/jaredhanson/passport-anonymous/badge.png)](https://coveralls.io/r/jaredhanson/passport-anonymous)
[![Dependencies](https://david-dm.org/jaredhanson/passport-anonymous.png)](http://david-dm.org/jaredhanson/passport-anonymous)


[Passport](http://passportjs.org/) strategy for anonymous authentication.

This module lets you provide anonymous authentication in your Node.js
applications.  By plugging into Passport, anonymous authentication can be easily
and unobtrusively integrated into any application or framework that supports
[Connect](http://www.senchalabs.org/connect/)-style middleware, including
[Express](http://expressjs.com/).

## Install

    $ npm install passport-anonymous

## Usage

#### Configure Strategy

The anonymous authentication strategy passes authentication for a request,
with `req.user` remaining `undefined`.

    passport.use(new AnonymousStrategy());

#### Authenticate Requests

Use `passport.authenticate()`, specifying the `'anonymous'` strategy, to
pass authentication of a request.  This is typically used alongside a strategy
that verifies credentials, as a fallback for routes that prefer authentication
but can also respond to unauthenticated requests.

For example, as route middleware in an [Express](http://expressjs.com/)
application:

    app.post('/hello', 
      passport.authenticate(['basic', 'anonymous'], { session: false }),
      function(req, res) {
        if (req.user) {
          res.json({ name: req.user.username });
        } else {
          res.json({ name: 'anonymous' });
        }
      });

## Examples

For a complete, working example, refer to the [login example](https://github.com/jaredhanson/passport-anonymous/tree/master/examples/basic).

## Tests

    $ npm install
    $ npm test

## Credits

  - [Jared Hanson](http://github.com/jaredhanson)

## License

[The MIT License](http://opensource.org/licenses/MIT)

Copyright (c) 2012-2013 Jared Hanson <[http://jaredhanson.net/](http://jaredhanson.net/)>

---
_Source: https://npm.io/package/passport-anonymous · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._