ueberauth_shopify v0.1.2 Ueberauth.Strategy.Shopify
Provides an Ueberauth strategy for authenticating with Shopify.
Setup
Create an application an embedded application in Shopify that your users will authenticate for use.
Register a new application at: your github developer page and get the client_id
and client_secret
.
Include the provider in your configuration for Ueberauth
config :ueberauth, Ueberauth,
providers: [
shopify: { Ueberauth.Strategy.Shopify, [] }
]
Then include the configuration for shopify.
config :ueberauth, Ueberauth.Strategy.Shopify.OAuth,
client_id: System.get_env("SHOPIFY_API_KEY"),
client_secret: System.get_env("SHOPIFY_SECRET")
If you haven’t already, create a pipeline and setup routes for your callback handler
pipeline :auth do
Ueberauth.plug "/auth"
end
scope "/auth" do
pipe_through [:browser, :auth]
get "/:provider/callback", AuthController, :callback
end
Create an endpoint for the callback where you will handle the Ueberauth.Auth
struct
defmodule MyApp.AuthController do
use MyApp.Web, :controller
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 uid_field
config :ueberauth, Ueberauth,
providers: [
shopify: { Ueberauth.Strategy.Shopify, [uid_field: :shop] }
]
Default is :login
To set the default ‘scopes’ (permissions):
config :ueberauth, Ueberauth,
providers: [
shopify: { Ueberauth.Strategy.Shopify, [default_scope: "read_products,read_customers,read_orders"] }
]
Deafult is “read_products,read_customers,read_orders”
Summary
Functions
Includes the credentials from the Shopify response
Callback implementation for Ueberauth.Strategy.extra/1
Cleans up the private area of the connection used for passing the raw Shopify response around during the callback
Handles the initial redirect to the Shopify authentication page
Callback implementation for Ueberauth.Strategy.info/1
Fetches the uid field from the Shopify response. This defaults to the option uid_field
which in-turn defaults to login
Functions
Callback implementation for Ueberauth.Strategy.extra/1
.
Cleans up the private area of the connection used for passing the raw Shopify response around during the callback.
Handles the initial redirect to the Shopify authentication page.
To customize the scope (permissions) that are requested by shopify include them as part of your url:
"https://{shop}.myshopify.com/admin/oauth/authorize?scope=read_products,read_customers,read_orders"
You can also include a state
param that shopify will return to you.
Callback implementation for Ueberauth.Strategy.info/1
.