Qiita
=====

Backend class
-------------

For Django, add this class path to ``AUTHENTICATION_BACKENDS``. For other
integrations, use the same class path in the framework-specific backend
setting.

.. list-table::
   :header-rows: 1

   * - Backend name
     - Class path
   * - ``qiita``
     - ``social_core.backends.qiita.QiitaOAuth2``

Qiita

- Register a new application at Qiita_, set the callback URL to
  ``http://example.com/complete/qiita/`` replacing ``example.com`` with your
  domain.

- Fill ``Client ID`` and ``Client Secret`` values in the settings::

      SOCIAL_AUTH_QIITA_KEY = ''
      SOCIAL_AUTH_QIITA_SECRET = ''

- Also it's possible to define extra permissions with::

      SOCIAL_AUTH_QIITA_SCOPE = [...]

  See auth scopes at `Qiita Scopes docs`_.

- Default behavior is to identify users by their `id`. However, this can be changed by renaming accounts, etc.

  If you want to identify each user with a unique `permanent_id`, set the following::

      SOCIAL_AUTH_QIITA_IDENTIFIED_BY_PERMANENT_ID = True

.. _Qiita: https://qiita.com/settings/applications
.. _Qiita Scopes docs: https://qiita.com/api/v2/docs#スコープ