{"id":25553782,"url":"https://github.com/docusign/passport-docusign","last_synced_at":"2025-04-11T22:43:17.778Z","repository":{"id":57320004,"uuid":"104619018","full_name":"docusign/passport-docusign","owner":"docusign","description":"The official DocuSign Passport package","archived":false,"fork":false,"pushed_at":"2024-06-21T20:08:41.000Z","size":23,"stargazers_count":8,"open_issues_count":2,"forks_count":7,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-25T18:45:23.548Z","etag":null,"topics":["docusign","electronic-signatures","oauth2","passport","signature"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/docusign.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-24T04:36:40.000Z","updated_at":"2025-02-01T05:37:17.000Z","dependencies_parsed_at":"2024-06-20T23:28:16.105Z","dependency_job_id":"702131d8-5cf1-4df5-bd91-1d12cdec5c99","html_url":"https://github.com/docusign/passport-docusign","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docusign%2Fpassport-docusign","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docusign%2Fpassport-docusign/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docusign%2Fpassport-docusign/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docusign%2Fpassport-docusign/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docusign","download_url":"https://codeload.github.com/docusign/passport-docusign/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248290465,"owners_count":21078992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docusign","electronic-signatures","oauth2","passport","signature"],"created_at":"2025-02-20T12:01:37.621Z","updated_at":"2025-04-11T22:43:17.736Z","avatar_url":"https://github.com/docusign.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"The Official DocuSign Passport package\n\n[![NPM version][npm-image]][npm-url]\n[![NPM downloads][downloads-image]][downloads-url]\n[![Build status][travis-image]][travis-url]\n\n[Passport](http://passportjs.org/) strategy for authenticating with [DocuSign](http://www.docusign.com/)\nusing the OAuth 2.0 API.\n\nThis module lets you authenticate using DocuSign in your Node.js applications.\nBy plugging into Passport, DocuSign authentication can be easily and\nunobtrusively integrated into any application or framework that supports\n[Connect](http://www.senchalabs.org/connect/)-style middleware, including\n[Express](http://expressjs.com/).\n\n## Requirements\n\nNode 0.8 or later.\n\n## Install\n\n    $ npm install passport-docusign\n\n## Usage\n\n#### Register your Application\n\nBefore using `passport-docusign`, you must register an application with\nDocuSign.  If you have not already done so, a new application can be created at\n[DocuSign Developers](https://www.docusign.com/developer-center).\n\n#### Configure Strategy\n\nThe DocuSign authentication strategy authenticates users using a DocuSign\naccount and OAuth 2.0 tokens.  The app ID and secret obtained when creating an\napplication are supplied as options when creating the strategy.  The strategy\nalso requires a `verify` callback, which receives the access token and optional\nrefresh token, as well as `profile` which contains the authenticated user's\nDocuSign profile.  The `verify` callback must call `cb` providing a user to\ncomplete authentication.\n\n```js\npassport.use(new DocusignStrategy({\n    clientID: DOCUSIGN_INTEGRATION_KEY,\n    clientSecret: DOCUSIGN_APP_SECRET,\n    callbackURL: \"http://localhost:3000/auth/docusign/callback\"\n  },\n  function(accessToken, refreshToken, profile, cb) {\n    User.findOrCreate({ email: profile.email }, function (err, user) {\n      return cb(err, user);\n    });\n  }\n));\n```\n\n#### Authenticate Requests\n\nUse `passport.authenticate()`, specifying the `'docusign'` strategy, to\nauthenticate requests.\n\nFor example, as route middleware in an [Express](http://expressjs.com/)\napplication:\n\n```js\napp.get('/auth/docusign',\n  passport.authenticate('docusign'));\n\napp.get('/auth/docusign/callback',\n  passport.authenticate('docusign', { failureRedirect: '/login' }),\n  function(req, res) {\n    // Successful authentication, redirect home.\n    res.redirect('/');\n  });\n```\n\n## Examples\n\nSee https://github.com/docusign/docusign-code-examples/blob/master/node/NodeSDKSamples.js#L32.\n\n## FAQ\n\n##### How do I use passport-docusign in production?\n\nAll you need to do is turn the 'production' flag to true.\n\n```js\napp.get('/auth/docusign',\n  passport.authenticate('docusign', { production: true }));\n```\n\n## Contributing\n\n#### Tests\n\nThe test suite is located in the `test/` directory.  All new features are\nexpected to have corresponding test cases.  Ensure that the complete test suite\npasses by executing:\n\n```bash\n$ make test\n```\n\n#### Coverage\n\nThe test suite covers 100% of the code base.  All new feature development is\nexpected to maintain that level.  Coverage reports can be viewed by executing:\n\n```bash\n$ make test-cov\n$ make view-cov\n```\n\n## License\n\n[The MIT License](http://opensource.org/licenses/MIT)\n\n[npm-image]: https://img.shields.io/npm/v/passport-docusign.svg?style=flat\n[npm-url]: https://npmjs.org/package/passport-docusign\n[downloads-image]: https://img.shields.io/npm/dm/passport-docusign.svg?style=flat\n[downloads-url]: https://npmjs.org/package/passport-docusign\n[travis-image]: https://img.shields.io/travis/docusign/passport-docusign.svg?style=flat\n[travis-url]: https://travis-ci.org/docusign/passport-docusign\n\n### Additional Resources\n* [DocuSign Developer Center](https://developers.docusign.com)\n* [DocuSign API on Twitter](https://twitter.com/docusignapi)\n* [DocuSign For Developers on LinkedIn](https://www.linkedin.com/showcase/docusign-for-developers/)\n* [DocuSign For Developers on YouTube](https://www.youtube.com/channel/UCJSJ2kMs_qeQotmw4-lX2NQ)\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocusign%2Fpassport-docusign","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocusign%2Fpassport-docusign","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocusign%2Fpassport-docusign/lists"}