markbates / markbates/goth

Bitrix24 Provider

Open
#533 1 comment 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
6.6k
Forks
631
PR merge metrics
No merged PRs in 30d

Description

Feature Description

Hello. I would like to suggest add new authentification provider for Bitrix24 (https://www.bitrix24.com/)

Bitrix24 is a product for collaboration, task and projects managment, CRM (JIRA Software Alternative).

Bitrix24 provider has possibility to develop integrations with authentications based on OAuth2 protocol, but has specific UserInfo api endpoint.

https://training.bitrix24.com/support/training/course/?COURSE_ID=169&LESSON_ID=20182
HOWTO setup Bitrix24:

  1. Open Bitrix24.
  2. Create new organization
  3. Go to Developer Resources->Other->Local Application
  4. Create new application
  5. Setup parameters:
  • App type: Server
  • Available as script only: yes
  • Your handler path: gitea auth handler
  • Initial installation path: empty
  • Application ID
  • Application key (client_secret)
  • Permissions: users_basic

image

How I think should look settings:

  1. Auth url
    https://yourcompanydomain.bitrix24.ru/oauth/authorize/
    or
    https://yourcompanydomain.bitrix24.com/oauth/authorize/
    I think gitea interface should have a field with property Company Bitrix URL: yourcompanydomain.bitrix24.com
    Or Company and Domain [ru|com]
  2. Fields ClientId and ClientSecret
  3. Handler URL (needs for Bitrix24. It does not accept return_urls)

Getting user info:
Need to send GET request for https://companydomain.bitrix24.ru/rest/user.current.json
You will get json with such structure:

{
  "response": {
    "ID":1,
    "NAME":"John",
    "LAST_NAME":"Doe",
    "EMAIL":"john.doe@yourcompany.ru"
    ...
  }
}

Bitrix24 allows make "local app intergation" only for enterprice subcription. But it have 2 weeks free period, also you can registrate new organization for test cases.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names no repository files, tests, or entry points. Start by examining how existing authentication providers handle OAuth2 configuration, callback URLs, and user-info requests; done means adding a Bitrix24 provider that supports the described company URL, credentials, handler URL, and user data response.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
api, authentication
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.