{"id":21953797,"url":"https://github.com/erlef/phx_gen_oidcc","last_synced_at":"2025-04-23T09:07:36.948Z","repository":{"id":194990254,"uuid":"691771627","full_name":"erlef/phx_gen_oidcc","owner":"erlef","description":":warning: Deprecated, use oidcc_plug Igniter Task","archived":true,"fork":false,"pushed_at":"2024-11-10T21:40:35.000Z","size":63,"stargazers_count":10,"open_issues_count":1,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-23T09:07:25.560Z","etag":null,"topics":["elixir","generator","openid","openid-connect","phoenix","phoenix-framework","security-wg"],"latest_commit_sha":null,"homepage":"https://hexdocs.pm/phx_gen_oidcc","language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erlef.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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},"funding":{"custom":"https://members.erlef.org/join-us"}},"created_at":"2023-09-14T21:21:05.000Z","updated_at":"2025-04-19T16:31:51.000Z","dependencies_parsed_at":"2024-01-17T22:44:40.880Z","dependency_job_id":"bde8941c-780d-49c3-a3c1-37deae862f78","html_url":"https://github.com/erlef/phx_gen_oidcc","commit_stats":null,"previous_names":["erlang-openid/phx_gen_oidcc"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erlef%2Fphx_gen_oidcc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erlef%2Fphx_gen_oidcc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erlef%2Fphx_gen_oidcc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erlef%2Fphx_gen_oidcc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erlef","download_url":"https://codeload.github.com/erlef/phx_gen_oidcc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250403833,"owners_count":21424794,"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":["elixir","generator","openid","openid-connect","phoenix","phoenix-framework","security-wg"],"created_at":"2024-11-29T07:13:07.742Z","updated_at":"2025-04-23T09:07:36.929Z","avatar_url":"https://github.com/erlef.png","language":"Elixir","funding_links":["https://members.erlef.org/join-us"],"categories":[],"sub_categories":[],"readme":"\u003cdiv style=\"margin-right: 15px; float: left;\"\u003e\n  \u003cimg\n    align=\"left\"\n    src=\"assets/logo.svg\"\n    alt=\"OpenID Connect Logo\"\n    width=\"170px\"\n  /\u003e\n\u003c/div\u003e\n\n# Phx Gen Oidcc\n\nAn OpenID Login Generator for Phoenix 1.7 Projects\n\n[![EEF Security WG project](https://img.shields.io/badge/EEF-Security-black)](https://github.com/erlef/security-wg)\n[![Main Branch](https://github.com/erlef/phx_gen_oidcc/actions/workflows/branch_main.yml/badge.svg?branch=main)](https://github.com/erlef/phx_gen_oidcc/actions/workflows/branch_main.yml)\n[![Module Version](https://img.shields.io/hexpm/v/phx_gen_oidcc.svg)](https://hex.pm/packages/phx_gen_oidcc)\n[![Total Download](https://img.shields.io/hexpm/dt/phx_gen_oidcc.svg)](https://hex.pm/packages/phx_gen_oidcc)\n[![License](https://img.shields.io/hexpm/l/phx_gen_oidcc.svg)](https://github.com/erlef/phx_gen_oidcc/blob/main/LICENSE)\n[![Last Updated](https://img.shields.io/github/last-commit/erlef/phx_gen_oidcc.svg)](https://github.com/erlef/phx_gen_oidcc/commits/master)\n[![Coverage Status](https://coveralls.io/repos/github/erlef/phx_gen_oidcc/badge.svg?branch=main)](https://coveralls.io/github/erlef/phx_gen_oidcc?branch=main)\n\n\u003cbr clear=\"left\"/\u003e\n\n\u003cpicture style=\"margin-right: 15px; float: left;\"\u003e\n  \u003csource\n    media=\"(prefers-color-scheme: dark)\"\n    srcset=\"assets/certified-dark.svg\"\n    width=\"170px\"\n    align=\"left\"\n  /\u003e\n  \u003csource\n    media=\"(prefers-color-scheme: light)\"\n    srcset=\"assets/certified-light.svg\"\n    width=\"170px\"\n    align=\"left\"\n  /\u003e\n  \u003cimg\n    src=\"assets/certified-light.svg\"\n    alt=\"OpenID Connect Certified Logo\"\n    width=\"170px\"\n    align=\"left\"\n  /\u003e\n\u003c/picture\u003e\n\nOpenID Certified by [Jonatan Männchen](https://github.com/maennchen) at the\n[Erlang Ecosystem Foundation](https://github.com/erlef) of multiple Relaying\nParty conformance profiles of the OpenID Connect protocol:\nFor details, check the\n[Conformance Test Suite](https://github.com/erlef/oidcc_conformance).\n\n\u003cbr clear=\"left\"/\u003e\n\n\u003cpicture style=\"margin-right: 15px; float: left;\"\u003e\n  \u003csource\n    media=\"(prefers-color-scheme: dark)\"\n    srcset=\"assets/erlef-logo-dark.svg\"\n    width=\"170px\"\n    align=\"left\"\n  /\u003e\n  \u003csource\n    media=\"(prefers-color-scheme: light)\"\n    srcset=\"assets/erlef-logo-light.svg\"\n    width=\"170px\"\n    align=\"left\"\n  /\u003e\n  \u003cimg\n    src=\"assets/erlef-logo-light.svg\"\n    alt=\"Erlang Ecosystem Foundation Logo\"\n    width=\"170px\"\n    align=\"left\"\n  /\u003e\n\u003c/picture\u003e\n\nThe development of the library and the certification is funded as an\n[Erlang Ecosystem Foundation](https://erlef.org/) stipend entered by the\n[Security Working Group](https://erlef.org/wg/security).\n\n\u003cbr clear=\"left\"/\u003e\n\nThis library has taken some inspiration from\n[@aaronrenner](https://github.com/aaronrenner)'s\n[`phx_gen_auth`](https://github.com/aaronrenner/phx_gen_auth).\n\n## Overview\n\nThe purpose of `phx.gen.oidcc` is to generate a pre-built authentication system\ninto a Phoenix 1.7 application that follows both security and elixir best\npractices. By generating code into the user's application instead of using a\nlibrary, the user has complete freedom to modify the authentication system so it\nworks best with their app.\n\n## Installation\n\nAfter running `mix phx.new`, `cd` into your application's directory\n(ex. `my_app`).\n\n1. Add `phx_gen_oidcc` to your list of dependencies in `mix.exs`\n    ```elixir\n    def deps do\n      [\n        {:phx_gen_oidcc, \"~\u003e 0.1.0\", only: [:dev], runtime: false},\n        ...\n      ]\n    end\n    ```\n1. Install and compile the dependencies\n    ```\n    $ mix do deps.get, deps.compile\n    ```\n\n## Running the generator\n\nFrom the root of your phoenix app, you\ncan install the authentication system with the following command\n\n```console\n$ mix phx.gen.oidcc \\\n    MyApp.ConfigProviderName \\\n    \"https://issuer.example.com\" \\\n    \"client_id\" \\\n    \"client_secret\"\n```\n\nThis creates the templates,views, and controllers on the web namespace, and\nstarts a new `Oidcc.ProviderConfiguration.Worker`, in the application.\n\nNext, let's install the dependencies\n\n```console\n$ mix deps.get\n```\n\nLet's run the tests and make sure our new authentication system works as\nexpected.\n\n```console\n$ mix test\n```\n\nFinally, let's start our phoenix server and try it out.\n\n```console\n$ mix phx.server\n```\n\n## Learning more\n\nTo learn more about `phx.gen.oidcc`, run the following command.\n\n```console\n$ mix help phx.gen.oidcc\n```\n\nYou can also look up the mix task in\n[hexdocs](https://hexdocs.pm/phx_gen_oidcc).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferlef%2Fphx_gen_oidcc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferlef%2Fphx_gen_oidcc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferlef%2Fphx_gen_oidcc/lists"}