Em quatro lançamentos públicos — do Apidog 2.8.41 ao 2.8.44 — agosto fortaleceu três partes conectadas das operações de API empresarial: conectividade Git governada, acesso a projetos baseado em identidade e administração baseada em API mais útil e rastreável.
As equipes de API empresariais gerenciam cada vez mais repositórios, identidades e associações através de sistemas fora da própria plataforma de API. Este mês, o Apidog melhora essas conexões, ao mesmo tempo em que oferece atualizações focadas em confiabilidade em configuração de projetos, importações, branches, documentação, fluxos de trabalho da CLI e execução de testes.
As principais atualizações são:
- GitHub Enterprise Cloud: Conecte o Apidog a implantações de residência de dados em domínios dedicados
*.ghe.com. - Governança de SSO e acesso a projetos: Mantenha as sessões de SSO empresarial focadas no trabalho da organização e inicialize as permissões de projeto através do Mapeamento de Grupo SAML.
- APIs de administração empresarial: Recupere dados mais úteis de membros da organização, automatize o onboarding de equipes com inicialização explícita de acesso a projetos e inclua operações administrativas suportadas baseadas em API na trilha de auditoria.
Melhorias adicionais de ambiente, política, internacionalização, especificação e fluxo de trabalho são resumidas após as três principais atualizações.
1. ☁️ GitHub Enterprise Cloud para Fluxos de Trabalho de Residência de Dados
Clientes do GitHub Enterprise Cloud com residência de dados podem hospedar repositórios em domínios dedicados *.ghe.com em vez do domínio público github.com. Até agora, isso criava uma lacuna para equipes que desejavam usar os fluxos de trabalho Git do Apidog sem mover repositórios governados para fora do ambiente GitHub existente de sua organização.
Conecte-se ao host *.ghe.com da sua organização
Os administradores da organização agora podem configurar um host do GitHub Enterprise Cloud junto com um ID de Cliente e um Segredo de Cliente de Aplicativo OAuth. O fluxo de autorização usa o host empresarial configurado, permitindo que o Apidog acesse as organizações, repositórios, branches e arquivos exigidos pelas operações Git suportadas.
A conexão se aplica a três fluxos de trabalho práticos:
- Conexão Git: Trabalhe com definições de API através do repositório e branch controlados pela sua organização.
- Importação de repositório: Importe arquivos OpenAPI ou Swagger de um repositório empresarial para o Apidog.
- Backup OpenAPI: Faça backup de definições de API para o repositório empresarial e branch selecionados pela equipe.
O resultado é a continuidade: as equipes podem manter sua governança de repositório e modelo de residência de dados enquanto usam os fluxos de trabalho de importação, backup e colaboração baseados em Git do Apidog.
Escopo: Esta atualização está limitada a implantações de residência de dados do GitHub Enterprise Cloud em domínios SaaS dedicados *.ghe.com. Não adiciona suporte geral para domínios auto-hospedados do GitHub Enterprise Server.2. 🛡️ Governança de SSO e Acesso a Projetos Mais Fortes
O SSO empresarial deve fazer mais do que autenticar um usuário. Deve manter a sessão focada no espaço de trabalho pretendido pela organização e traduzir a associação ao provedor de identidade em acesso previsível aos projetos onde o trabalho acontece.
Mantenha as sessões de SSO empresarial focadas no trabalho da organização
Com o isolamento de sessão SSO habilitado, o Apidog reduz os pontos de entrada em equipes e projetos pessoais. Ele também limita as ações selecionadas que poderiam mover, copiar ou clonar o trabalho da organização para espaços pessoais. Os usuários permanecem focados na organização e equipe associadas à sua sessão SSO, enquanto os administradores obtêm uma separação mais clara entre fluxos de trabalho empresariais e pessoais.
Esses controles fortalecem o limite de acesso pretendido sem alterar a experiência normal para organizações que não habilitam o isolamento de sessão SSO.
Leve a associação de equipe para o acesso em nível de projeto
O Mapeamento de Grupo SAML agora se estende além da associação a organizações e equipes, inicializando o acesso a projetos sob a equipe sincronizada. As funções iniciais do projeto seguem uma regra simples:
| Função da equipe sincronizada | Acesso inicial a projetos sob a equipe |
|---|---|
| Administrador da equipe | Editor |
| Outro Membro da equipe | Somente leitura |
Quando um usuário mapeado é removido da equipe, o Apidog sincroniza também a associação de projeto relacionada. Isso fecha a lacuna operacional entre grupos de provedores de identidade, funções de equipe e as permissões de projeto que os usuários precisam após o login.
Por que isso importa: Os administradores gastam menos tempo corrigindo a associação de projeto após o onboarding ou offboarding, e os usuários entram nos projetos da equipe com um nível inicial de acesso claro e consistente.
3. 📋 APIs de Administração Empresarial Mais Completas e Auditáveis
Os administradores empresariais frequentemente dependem de APIs para inventariar membros, conectar sistemas de identidade e automatizar a administração de rotina. Esses fluxos de trabalho só são confiáveis quando a API retorna dados úteis de membros, o comportamento de onboarding é explícito e protetor, e as operações automatizadas permanecem visíveis para as equipes de governança.
Recupere dados mais úteis de membros da organização
A API de Membros da Organização agora fornece endereços de e-mail e nomes de membros mais confiáveis, além das informações de associação existentes:
GET /v1/organizations/{organizationId}/members
Quando um membro não definiu um apelido, o Apidog pode usar outras informações de perfil disponíveis para o nome retornado. Membros sem um endereço de e-mail disponível, incluindo registros pendentes ou provisionados aplicáveis, retornam um valor explícito null em vez de um campo ausente ambíguo.
Isso torna a API mais prática para:
- Inventário de membros: Identifique os membros da organização com as informações que os administradores geralmente precisam para revisão.
- Sincronização automatizada: Use dados de membros estáveis em fluxos de trabalho externos de identidade e administração.
- Revisão de acesso: Compare registros de associação sem depender de uma exportação manual separada de CSV para detalhes básicos.
Atribua funções de equipe e inicialize o acesso a projetos através da API
Os administradores empresariais agora podem adicionar um usuário a uma equipe por e-mail e atribuir uma função de equipe embutida suportada através da API externa:
POST /v1/team-access-grants
Cada solicitação seleciona explicitamente tanto a função da equipe — Administrador, Membro ou Convidado — quanto como o acesso a projetos já sob a equipe deve ser inicializado. Com mapped, o Apidog inicializa o acesso a projetos ausente de acordo com a função da equipe selecionada, preservando as funções de projeto válidas existentes. Com none, o usuário se junta à equipe sem receber permissões de membro do projeto, para que o acesso possa ser atribuído separadamente.
O endpoint também suporta convites para usuários que ainda não se juntaram à organização e a restauração de membros que anteriormente deixaram a equipe. Membros de equipe existentes ativos ou pendentes e Proprietários de Equipe são protegidos contra alterações indesejadas, tornando as chamadas repetidas mais seguras para fluxos de trabalho de onboarding automatizados.
Escopo: A inicialização do acesso ao projeto se aplica a projetos que já existem sob a equipe quando um usuário se junta ou é restaurado pela primeira vez. Não sincroniza continuamente as permissões nem se aplica automaticamente a projetos futuros, e o endpoint não atribui Proprietário da Equipe, Gerente de Faturamento ou Funções de Equipe personalizadas.
Mantenha a administração impulsionada por API suportada na trilha de auditoria
Operações de API administrativas externas suportadas que correspondem a eventos de auditoria existentes agora são incorporadas à trilha de auditoria. Isso oferece às equipes de governança uma melhor continuidade entre as ações realizadas na interface do Apidog e as ações suportadas realizadas por meio de automação.
Juntos, dados de membros mais ricos, automação de acesso à equipe mais segura e cobertura de auditoria mais ampla tornam a administração empresarial mais fácil de automatizar sem perder a visibilidade necessária para revisão operacional.
Escopo: A cobertura de auditoria se aplica a operações de API externas suportadas associadas a eventos de auditoria existentes; não deve ser interpretada como registro universal de cada solicitação de API ou endpoint de gerenciamento.
✨ Mais Melhorias
Agosto também inclui um conjunto de melhorias focadas em configuração de ambiente, política empresarial, internacionalização, fluxos de trabalho de especificação e administração de projetos.
Gestão de empresas e ambientes
- Política de associação à organização: Administradores empresariais podem restringir a associação à organização a membros com endereços de e-mail especificados, ajudando a manter o acesso alinhado com as regras de identidade aprovadas.
- Política de Recompensa por Convite: As organizações podem desativar recompensas de Crédito e e-mails relacionados para convites enviados da organização e de suas equipes ou projetos.
- Navegação mais rápida na URL Base do Módulo: Quando um projeto tem mais de cinco módulos, as entradas após as cinco primeiras são recolhidas automaticamente, enquanto a pesquisa ajuda os usuários a localizar a configuração de serviço de que precisam.
- E-mails de sistema localizados: Os e-mails de sistema do Apidog agora seguem o idioma selecionado pelo destinatário, com inglês usado quando uma preferência de idioma do Apidog não está disponível.
- Equipes de propriedade da organização mais gerenciáveis: Proprietários e Administradores da Organização podem visualizar cada Proprietário de Equipe e status de proprietário, pesquisar ou filtrar equipes por esses campos e transferir a propriedade para uma ou várias equipes. Isso torna os espaços de trabalho pessoais gerenciados pela organização mais fáceis de identificar e transferir quando a propriedade muda.
- Gerenciamento mais claro de membros do projeto: A edição em massa de membros, diálogos de detalhes de membros e configurações de permissão são mais fáceis de trabalhar, enquanto as funções de Proprietário de Equipe são protegidas contra alterações não suportadas.
- Páginas de administração empresarial refinadas: Layouts mais consistentes, links de ajuda e apresentação de atualização melhoram a navegação nas configurações empresariais, políticas, logs de auditoria, scanner de segredos e páginas SAML SSO sem alterar a lógica de permissão existente.
Configuração de projeto, importações e especificações
- Troca de modo mais segura durante a criação do projeto: As informações já inseridas no formulário de criação do projeto são mantidas ao alternar entre o Modo Geral e o Modo de Especificação.
- Importações de arquivo Postman aprimoradas: As importações agora suportam variáveis globais e tratam espaços em nomes de variáveis automaticamente, reduzindo a limpeza após a migração.
- Melhor suporte a
$refentre arquivos no Modo de Especificação: As visualizações de endpoint podem resolver corpos de solicitação, esquemas e respostas suportados armazenados em arquivos OpenAPI separados. A linting espectral em arquivos referenciados, referências completas de endpoint e referências entre arquivos no Modo Formulário permanecem fora deste escopo.
Juntas, essas melhorias reduzem o atrito recorrente na configuração e administração sem competir com os três principais fluxos de trabalho empresariais da versão.
🛠️ Correções de Bugs Notáveis
Os lançamentos de agosto também abordaram problemas de confiabilidade em branches Git, importação e exportação de OpenAPI, documentação compartilhada, dados criados por CLI e execução de testes. As correções mais importantes se enquadram em três grupos de fluxo de trabalho.
Fluxos de trabalho mais seguros para branch, importação, exportação e geração de código
- As importações OpenAPI do Apidog CLI agora escrevem para o branch selecionado pelo usuário, em vez de escreverem incorretamente para o branch principal.
- As exportações de documentos de lançamento de sub-branches não incluem mais endpoints de módulos não relacionados ou pastas vazias.
- Fusões multi-branch transferem de forma mais confiável endpoints, cenários de teste e outros recursos para o branch de destino.
- A ação Criar Conexão de Repositório Git responde corretamente durante a importação OpenAPI.
- As exportações OpenAPI e CLI agora respeitam módulos, tags e pastas selecionados, em vez de incluírem um conjunto mais amplo de endpoints sem intenção.
- Esquemas referenciados entre módulos são preservados de forma mais confiável durante a geração de código.
- Esquemas de Segurança relacionados a AND são exportados corretamente, em vez de serem mesclados em uma representação interna imprecisa.
Validação mais precisa e documentação compartilhada
- A validação de resposta em modo estrito agora lida corretamente com esquemas compostos com
allOf. - Esquemas referenciados através de
Propriedades adicionaisaparecem corretamente na documentação de API compartilhada. - Exemplos padrão são exibidos corretamente na documentação compartilhada.
- As abas de documentos Markdown são renderizadas completamente quando usuários não logados visitam projetos públicos.
Dados CLI e execução de testes mais confiáveis
- Variáveis globais criadas via IA ou Apidog CLI não produzem mais nomes de variáveis vazios no lado do cliente.
- Valores de tag inválidos criados pelo Apidog CLI não causam mais erros de acesso no frontend.
- Dados de teste em nível de projeto criados sem
--scenariopermanecem visíveis na lista de dados. - Os detalhes de execução de pré e pós-processadores aparecem no console enquanto uma solicitação SSE está em execução, em vez de apenas após a solicitação terminar.
- Os nomes dos conjuntos de dados permanecem visíveis quando as execuções de teste usam variáveis de conjuntos de dados de texto longo.
Essas correções reduzem a chance de que um fluxo de trabalho correto produza um destino de branch errado, uma exportação incompleta, documentação ausente ou feedback de teste enganoso.
🌟 O Que Isso Significa
As principais atualizações de agosto fortalecem três partes conectadas do modelo operacional de API empresarial:
| Foco | O que melhora | Por que importa |
|---|---|---|
| Conectividade Git governada | O Apidog pode se conectar a hosts de residência de dados do GitHub Enterprise Cloud em *.ghe.com para conexão Git, importação de repositório e backup OpenAPI. |
As equipes mantêm os repositórios no ambiente GitHub e na estrutura de branches que sua organização controla. |
| Acesso de identidade ao projeto | As sessões SSO reduzem os pontos de entrada em espaços pessoais, enquanto o Mapeamento de Grupo SAML inicializa e mantém a associação ao projeto. | O onboarding e o offboarding tornam-se mais previsíveis, com menos correção manual de permissões. |
| Administração auditável | As APIs de membros da organização retornam dados de identidade mais úteis, a API de Concessão de Acesso a Equipes automatiza o onboarding protegido de equipes com inicialização explícita de acesso a projetos, e as operações administrativas externas suportadas alimentam eventos de auditoria existentes. | As equipes podem automatizar mais a administração sem abrir mão do controle e da visibilidade necessários para onboarding, inventário, revisão de acesso e governança. |
As melhorias adicionais de ambiente, política, especificação e confiabilidade tornam os fluxos de trabalho diários mais confiáveis, mas a direção maior é consistente: manter a governança de repositórios, o acesso de identidade e a automação administrativa alinhados à medida que os programas de API empresarial crescem.
💬 Participe da Conversa
Conecte-se com outros engenheiros de API e com a equipe Apidog:
- Junte-se à nossa comunidade no Discord para discussões e suporte em tempo real.
- Participe da nossa comunidade no Slack para conversas técnicas.
- Siga-nos no X (Twitter) e LinkedIn para as últimas atualizações.
P.S. Para as notas de lançamento item a item, consulte o Changelog do Apidog, incluindo as versões 2.8.41, 2.8.42, 2.8.43 e 2.8.44.
Atenciosamente,
A Equipe Apidog