Provides an Ueberauth strategy for authenticating with Amco.

Setup

Request to Amco IT an application in Amco for you to use.

Include the provider in your configuration for Ueberauth;

config :ueberauth, Ueberauth,
  providers: [
    amco: { Gamora, [] }
  ]

Then include the configuration for Amco:

config :ueberauth, Gamora.OAuth,
  client_id: System.get_env("AMCO_CLIENT_ID"),
  client_secret: System.get_env("AMCO_CLIENT_SECRET")

If you haven't already, setup routes for your request and callback handler

scope "/auth" do
  pipe_through [:browser, :auth]

  get "/:provider", AuthController, :request
  get "/:provider/callback", AuthController, :callback
end

Create an endpoint for the request and callback where you will handle the Ueberauth.Auth struct:

defmodule MyApp.AuthController do
  use MyApp.Web, :controller

  plug Ueberauth

  def callback_phase(%{ assigns: %{ ueberauth_failure: fails } } = conn, _params) do
    # do things with the failure
  end

  def callback_phase(%{ assigns: %{ ueberauth_auth: auth } } = conn, params) do
    # do things with the auth
  end
end

You can edit the behaviour of the Strategy by including some options when you register your provider.

To set the prompt:

config :ueberauth, Ueberauth,
  providers: [
    amco: { Gamora, [prompt: "login"] }
  ]

To set the default 'scopes' (permissions):

config :ueberauth, Ueberauth,
  providers: [
    amco: { Gamora, [default_scope: "openid email phone"] }
  ]

Default is empty ("openid profile email").