{"id":16085689,"url":"https://github.com/iamraphson/allyproviders","last_synced_at":"2025-06-12T15:07:37.997Z","repository":{"id":57176694,"uuid":"168426093","full_name":"iamraphson/AllyProviders","owner":"iamraphson","description":"A Collection of Providers for AdonisJS Ally","archived":false,"fork":false,"pushed_at":"2019-02-04T14:29:05.000Z","size":9,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-05T13:44:04.103Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/allyproviders","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/iamraphson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-30T22:34:56.000Z","updated_at":"2019-02-15T11:17:46.000Z","dependencies_parsed_at":"2022-09-04T11:10:14.211Z","dependency_job_id":null,"html_url":"https://github.com/iamraphson/AllyProviders","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/iamraphson/AllyProviders","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2FAllyProviders","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2FAllyProviders/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2FAllyProviders/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2FAllyProviders/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamraphson","download_url":"https://codeload.github.com/iamraphson/AllyProviders/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2FAllyProviders/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259490544,"owners_count":22865766,"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":[],"created_at":"2024-10-09T13:08:57.647Z","updated_at":"2025-06-12T15:07:37.966Z","avatar_url":"https://github.com/iamraphson.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Adonis Ally Provider\n\n**A Collection of Providers for Adonis Ally**\n\n\n### Install\n\n`npm install --save allyproviders  @adonisjs/ally` or `yarn add allyproviders  @adonisjs/ally`\n\n\n### Usage\n\n- Register the provider\n\nThe provider needs to be registered inside `start/app.js` file.\n\n```\nconst providers = [\n  '@adonisjs/ally/providers/AllyProvider'\n]\n```\n\n- Register the driver \n\nThe driver must be registered as a hook inside `app/hooks.js` file.\n\n```\nconst { ioc } = require('@adonisjs/fold')\nconst { hooks } = require('@adonisjs/ignitor')\n\nconst { mydriver } = require('allyproviders') //E.g const { bitbucket } = require('allyproviders')\n\nhooks.before.providersRegistered(() =\u003e {\n  ioc.extend('Adonis/Addons/Ally', 'mydriver', () =\u003e mydriver) //E.g ioc.extend('Adonis/Addons/Ally', 'bitbucket', () =\u003e bitbucket)\n})\n```\n\n- Configure driver\n\nConfiguration data are defined inside `config/services.js` file under ally object. \n```\n//...\nally: {\n  mydriver: {\n    clientId: '',\n    clientSecret: '',\n    redirectUri: ''\n  },\n  bitbucket: {\n    clientId: '',\n    clientSecret: '',\n    redirectUri: ''\n  }\n}\n//...\n```\n\n### Getting Started\n\n**Redirect user to 3rd party website**\n```\n    await ally.driver('mydriver').redirect()\n```\n\n**Get redirect URL back**\n```\nconst url = await ally.driver('mydriver').getRedirectUrl()\n```\n\n**Get user details on the redirect URL**\n```\nconst user = await ally.driver('mydriver').getUser()\n```\n\n**Returns the user details using Access token or / and Access secret**\n```\nconst user = await ally.driver('mydriver').getUserByToken(accessToken, [accessSecret])\n```\n\n### More Documentation\n\nCheck out the [official documentation](http://adonisjs.com/docs/social-auth)\n\n### Tests\nTests are written using [japa](http://github.com/thetutlage/japa). Run the following commands to run tests.\n```\nnpm run test\n```\n\n### Contributing\n1. Fork it!\n2. Create your feature branch: `git checkout -b feature-name`\n3. Commit your changes: `git commit -am 'Some commit message'`\n4. Push to the branch: `git push origin feature-name`\n5. Submit a pull request 😉😉\n\n### How can I thank you?\n\nWhy not star the github repo? I'd love the attention! Why not share the link for this repository on Twitter or Any Social Media? Spread the word!\n\nDon't forget to [follow me on twitter](https://twitter.com/iamraphson)!\n\nThanks!\nAyeni Olusegun.\n\n### License\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamraphson%2Fallyproviders","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamraphson%2Fallyproviders","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamraphson%2Fallyproviders/lists"}