Axoria
PT EN
Criar conta

Integrações

O Axoria suporta integração nativa com o GitHub para automação de fluxo de trabalho de desenvolvimento.

Acesse em Configurações da Organização → Integrações.

GitHub

A integração com o GitHub permite a criação automática de branches ao criar uma issue.

Quando uma issue é criada num projeto com a integração ativa, o Axoria cria automaticamente uma branch no repositório vinculado, no formato:

axoria/{tipo}/{chave}-{slug-do-titulo}

Exemplo: axoria/bug/SHOP-42-falha-na-validacao-de-cpf

Configuração na Organização

  1. Acesse Configurações da Organização → Integrações.
  2. Clique em Adicionar Integração → GitHub.
  3. Informe um Personal Access Token (PAT) do GitHub.
    • O token precisa do escopo repo para repositórios privados ou public_repo para públicos.
    • As credenciais são armazenadas de forma criptografada.

Configuração por Projeto

Cada projeto pode ativar a integração de forma independente:

  1. Acesse Configurações do Projeto → Integrações.
  2. Ative a integração GitHub criada na organização.
  3. Configure:
    • Repositório: owner/repo ou URL completa (ex.: https://github.com/minha-org/meu-repositorio)
    • Branch base: branch de origem para criar as novas branches (padrão: main)
    • Tipos de issue que disparam: selecione quais tipos de issue (ex.: BUG, TASK, HOTFIX) devem acionar a criação de branch

Comportamento

  • A branch é criada de forma assíncrona após o commit da criação da issue.
  • O formato do nome da branch é: axoria/{tipo}/{CHAVE}-{slug} (o slug é gerado a partir do título da issue, limitado a 50 caracteres).
  • Se o token não tiver permissão (403) ou estiver inválido (401), o erro é registrado nos logs do servidor. A issue é criada normalmente mesmo que a criação da branch falhe.

Permissões

Apenas Owner ou Admin da organização pode configurar integrações no nível da organização. A ativação por projeto pode ser feita por membros com papel PROJECT_ADMIN.

Integrações Disponíveis

GitHub

Vincule repositórios GitHub a projetos do Axoria:

  • Pull Requests: ao mencionar uma chave de issue no título ou corpo de um PR (ex.: SHOP-42), o PR é automaticamente vinculado à issue
  • Commits: commits com a chave da issue no mensagem são listados no painel de detalhes da issue
  • Status de CI: o status do último check de CI do PR é exibido na issue vinculada
  • Auto-close: ao mesclar um PR, o sistema pode mover automaticamente a issue para status DONE (configurável)

Como configurar:

  1. Em Integrações, clique em Conectar → GitHub.
  2. Autorize o Axoria no GitHub OAuth.
  3. Selecione os repositórios que deseja vincular.
  4. Configure as regras de auto-close (opcional).

GitLab

Funcionalidade equivalente ao GitHub:

  • Vinculação de Merge Requests a issues por chave no título/descrição
  • Commits referenciando chaves de issue
  • Status de pipeline CI/CD na issue
  • Auto-close ao mesclar MR

Bitbucket

  • Vinculação de Pull Requests a issues por chave na mensagem
  • Commits referenciando chaves de issue

ServiceNow

Sincronização bidirecional de incidentes:

  • De ServiceNow para Axoria: incidentes criados no ServiceNow podem gerar issues automáticas no Axoria com tipo BUG ou HOTFIX
  • De Axoria para ServiceNow: ao mover uma issue vinculada para DONE, o incidente correspondente no ServiceNow é atualizado
  • Mapeamento de campos configurável (prioridade, categoria, assignee)

SSO Corporativo (SAML / OIDC)

Autenticação federada para organizações com identidade centralizada:

Protocolo Casos de Uso
SAML 2.0 Active Directory, Okta, Azure AD, PingFederate
OpenID Connect (OIDC) Google Workspace, Keycloak, Auth0, AWS Cognito

Como configurar:

  1. Em Integrações, clique em Configurar SSO.
  2. Selecione o protocolo.
  3. Insira os metadados do provedor de identidade (IdP):
    • SAML: URL de metadata ou upload do XML
    • OIDC: issuer_url, client_id, client_secret
  4. Configure o mapeamento de atributos (email, nome, grupos).
  5. Ative e teste com um usuário piloto.

Com SSO ativo, membros da organização fazem login via o IdP configurado. Logins locais (email/senha) podem ser desabilitados para forçar o uso do SSO.

Permissões

Apenas o Owner ou Admin da organização pode configurar integrações. Membros comuns não têm acesso ao Hub de Integrações.

Use a Navegação lateral para explorar toda a Documentação.