Popularity
4.7
Growing
Activity
3.0
Declining
16
5
12

Monthly Downloads: 1,004
Programming language: Elixir
License: MIT License
Tags: Authentication    
Latest version: v0.3.1

ueberauth_vk alternatives and similar packages

Based on the "Authentication" category

Do you think we are missing an alternative of ueberauth_vk or a related project?

Add another 'Authentication' Package

README

Überauth VK

Build Status Coverage Status Hex Version License

VK OAuth2 strategy for Überauth.

Requirements

We support elixir versions 1.4 and above.

Installation

  1. Setup your application at VK Developers.

  2. Add :ueberauth_vk to your list of dependencies in mix.exs:

    def deps do
      # installation via hex:
      [{:ueberauth_vk, "~> 0.3"}]
      # if you want to use github:
      # [{:ueberauth_vk, github: "sobolevn/ueberauth_vk"}]
    end
    
  3. Add the strategy to your applications:

    def application do
      [applications: [:ueberauth_vk]]
    end
    
  4. Add VK to your Überauth configuration:

    config :ueberauth, Ueberauth,
      providers: [
        vk: {Ueberauth.Strategy.VK, []}
      ]
    
  5. Update your provider configuration:

    config :ueberauth, Ueberauth.Strategy.VK.OAuth,
      client_id: System.get_env("VK_CLIENT_ID"),
      client_secret: System.get_env("VK_CLIENT_SECRET")
    
  6. Include the Überauth plug in your controller:

    defmodule MyApp.AuthController do
      use MyApp.Web, :controller
      plug Ueberauth
      ...
    end
    
  7. Create the request and callback routes if you haven't already:

    scope "/auth", MyApp do
      pipe_through :browser
    
      get "/:provider", AuthController, :request
      get "/:provider/callback", AuthController, :callback
    end
    
  8. You controller needs to implement callbacks to deal with Ueberauth.Auth and Ueberauth.Failure responses.

For an example implementation see the Überauth Example application.

Customizing

You can customize multiple fields, such as default_scope, default_display, default_state, profile_fields, and uid_field.

Scope

By default the requested scope is "public_profile". Scope can be configured either explicitly as a scope query value on the request path or in your configuration:

config :ueberauth, Ueberauth,
  providers: [
    vk: {Ueberauth.Strategy.VK, [default_scope: "friends,video,offline"]}
  ]

Profile Fields

You can also provide custom fields for user profile:

config :ueberauth, Ueberauth,
  providers: [
    vk: {Ueberauth.Strategy.VK, [profile_fields: "photo_200,location,online"]}
  ]

See VK API Method Reference > User for full list of fields.

State

You can also set the custom field called state. It is used to prevent "man in the middle" attacks.

config :ueberauth, Ueberauth,
  providers: [
    vk: {Ueberauth.Strategy.VK, [default_state: "secret-state-value"]}
  ]

This state will be passed to you in the callback as /auth/vk?state=<session_id> and will be available in the success struct.

UID Field

You can use alternate fields to identify users. For example, you can use email.

config :ueberauth, Ueberauth,
  providers: [
    vk: {Ueberauth.Strategy.VK, [
      default_scope: "email",
      uid_field: :email
    ]}
  ]

License

MIT. Please see LICENSE.md for licensing details.


*Note that all licence references and agreements mentioned in the ueberauth_vk README section above are relevant to that project's source code only.