🌐 Ambientes e Endpoints
📖 Visão Geral
A Credsystem disponibiliza dois ambientes para testes e produção. Cada ambiente possui:
- 🔐 Credenciais independentes (Client ID e Secret próprios)
- 🌍 URLs base específicas
- 📊 Dados isolados (não há compartilhamento entre ambientes)
- ⚙️ Configurações específicas de segurança e rate limiting
Sempre desenvolva e teste em Homologação antes de migrar para Produção. Nunca use Produção para testes ou desenvolvimento.
🎯 Ambientes Disponíveis
✅ Homologação (HML)
Ambiente estável para testes integrados, validação e homologação antes de ir para produção.
Características:
- 🎯 Ambiente estável e controlado
- 🔒 Dados de teste consistentes
- 📊 Mesmas regras de negócio da produção
- ✅ Base para testes de integração e aceitação
- 🧪 Simula comportamento de produção
Quando usar:
- Testes de integração completos
- Validação de fluxos de negócio
- Testes de performance e carga
- Homologação com o time de QA
- Demonstrações para stakeholders
URL Base:
https://apihml.credsystem.com.br
URL Base Autenticação:
A Credsystem suporta dois provedores de identidade, dependendo do ambiente e do produto contratado:
Red Hat SSO (RHSSO)
| Ambiente | URL Base de Autenticação |
|---|---|
| Homologação | https://ssohml.credsystem.com.br/auth/realms/{realm}/protocol/openid-connect |
Substitua
{realm}pelo realm fornecido nas suas credenciais de acesso. Para mais detalhes sobre o fluxo de autenticação, consulte o guia de Autenticação.
Oracle IDCS
| Ambiente | URL Base de Autenticação |
|---|---|
| Homologação | https://idcs-0fe1bec59571471484a8896c1a0d7a62.identity.oraclecloud.com/oauth2/v1 |
🚀 Produção (PRD)
Ambiente de operação real com dados e transações reais. Use com cuidado!
Características:
- 💼 Dados e transações reais
- 🔐 Segurança máxima
- 📈 Monitoramento 24/7
- ⚡ Alta disponibilidade (SLA garantido)
- 🛡️ Rate limiting mais restritivo
Quando usar:
- Apenas após homologação completa
- Operação real com clientes finais
- Transações financeiras reais
URL Base:
https://api.credsystem.com.br
URL Base Autenticação:
A Credsystem suporta dois provedores de identidade, dependendo do ambiente e do produto contratado:
** Red Hat SSO (RHSSO)**
| Ambiente | URL Base de Autenticação |
|---|---|
| Produção | https://ssoprd.credsystem.com.br/auth/realms/{realm}/protocol/openid-connect |
Substitua
{realm}pelo realm fornecido nas suas credenciais de acesso. Para mais detalhes sobre o fluxo de autenticação, consulte o guia de Autenticação.
Oracle IDCS
| Ambiente | URL Base de Autenticação |
|---|---|
| Produção | https://idcs-0fe1bec59571471484a8896c1a0d7a62.identity.oraclecloud.com/oauth2/v1 |
📊 Comparativo entre Ambientes
| Aspecto | Homologação | Produção |
|---|---|---|
| URL Base | https://apihml.credsystem.com.br | https://api.credsystem.com.br |
| Estabilidade | ✅ Estável | ✅ Alta disponibilidade |
| Dados | 🧪 Dados de teste fixos | 💼 Dados reais |
| Credenciais | 🔑 Específicas (HML) | 🔑 Específicas (PRD) |
| Monitoramento | ⚠️ Médio | ✅ 24/7 |
| SLA | ⚠️ Best effort | ✅ Contratual |
| Rate Limiting | ⚠️ Médio | 🔒 Restritivo |
| Suporte | 📧 📞 Prioritário |
##�🔐 Credenciais por Ambiente
Cada ambiente requer credenciais próprias. Você não pode usar credenciais de Homologação em Produção ou vice-versa.
Como Solicitar Credenciais
-
Acesse o Portal do Desenvolvedor: Solicitar Credenciais
-
Selecione o(s) Ambiente(s):
- ✅ Homologação (recomendado para começar)
- ✅ Produção (após homologação completa)
-
Especifique as APIs necessárias
-
Aguarde aprovação (até 72 horas úteis)
-
Receba suas credenciais por e-mail:
Client ID: [ESPECÍFICO DO AMBIENTE]Client Secret: [ESPECÍFICO DO AMBIENTE]
Exemplo de credenciais por ambiente:
# Homologação
CREDSYSTEM_CLIENT_ID_HML=af9c9e3ca3aa4390b86083ebe123abc
CREDSYSTEM_CLIENT_SECRET_HML=5a948d61-c135-4671-9d6a-d0a232123abcde
# Produção
CREDSYSTEM_CLIENT_ID_PRD=xyz789def456ghi012jkl345mno678pq
CREDSYSTEM_CLIENT_SECRET_PRD=9b876d54-e321-0fed-cba9-876543210fed
Você receberá e-mails separados com as credenciais de cada ambiente. Não confunda as credenciais!
🔄 Fluxo de Desenvolvimento Recomendado
⚙️ Configuração no Código
Variáveis de Ambiente
Recomendamos usar variáveis de ambiente para gerenciar URLs e credenciais:
Arquivo .env.homologacao:
CREDSYSTEM_ENV=homologacao
CREDSYSTEM_BASE_URL=https://apihml.credsystem.com.br
# Red Hat SSO (RHSSO)
CREDSYSTEM_AUTH_URL=https://ssohml.credsystem.com.br/auth/realms/{realm}/protocol/openid-connect/token
CREDSYSTEM_CLIENT_ID=seu_client_id_hml
CREDSYSTEM_CLIENT_SECRET=seu_client_secret_hml
Arquivo .env.producao:
CREDSYSTEM_ENV=producao
CREDSYSTEM_BASE_URL=https://api.credsystem.com.br
# Red Hat SSO (RHSSO) — use uma das opções abaixo conforme o provedor das suas credenciais:
CREDSYSTEM_AUTH_URL=https://ssoprd.credsystem.com.br/auth/realms/{realm}/protocol/openid-connect/token
# Oracle IDCS
# CREDSYSTEM_AUTH_URL=https://idcs-0fe1bec59571471484a8896c1a0d7a62.identity.oraclecloud.com/oauth2/v1/token
CREDSYSTEM_CLIENT_ID=seu_client_id_prd
CREDSYSTEM_CLIENT_SECRET=seu_client_secret_prd
Substitua
{realm}pelo realm fornecido nas suas credenciais. O provedor de autenticação (RHSSO ou IDCS) é informado junto com as credenciais de produção.
Adicione os arquivos .env* ao seu .gitignore para nunca commitar credenciais!
🆘 Suporte
Problemas de Ambiente
Se você encontrar problemas específicos de ambiente:
Homologação:
- 📧 E-mail: suporte.tecnico@credsystem.com.br
- ⏰ Horário: Segunda a Sexta, 8h às 18h (BRT)
Produção:
- 📧 E-mail: suporte.tecnico@credsystem.com.br
- ⏰ Horário: 24x7 para incidentes críticos
Quando entrar em contato, informe:
- ✅ Ambiente afetado (Homologação ou Produção)
- ✅ Client ID (nunca envie o Client Secret)
- ✅ Endpoint/URL sendo acessado
- ✅ Código de erro recebido
- ✅ Timestamp da ocorrência
- ✅ Log da requisição (sem dados sensíveis)
🚀 Próximos Passos
Agora que você conhece os ambientes disponíveis:
- 📝 Solicite suas credenciais para Homologação
- 🔐 Configure a autenticação no seu código
- 📖 Explore as APIs disponíveis
- 🧪 Teste em Homologação até validar tudo
- ✅ Solicite credenciais de Produção
- 🚀 Migre para Produção após homologação completa
Boa integração! 🎯