diagnos
A biblioteca Python por trás do cofre: importe-a, toque em `vault.patients` e o desbloqueio acontece sozinho — cifrado no seu próprio processo, do princípio ao fim.
Dev Center
Integre com SDK, CLI ou API
SDK em Python, CLI e uma API REST autenticada por mTLS — as chaves nascem e vivem só na memória do seu processo, e o servidor nunca vê nada além de texto cifrado.
Pacotes de código aberto
Experiência de programação simplificada
Oferecemos um SDK em Python, uma CLI compatível com Windows, Mac e Linux, e uma API RESTful pronta para ambiente de contentor ou Kubernetes — tudo mantendo a cifragem de ponta a ponta (E2E), e tudo como código aberto sob licença Apache 2.0.
-
-
diagnos-cli
Todo o SDK, direto no seu terminal: o `diagnos login` trata do enrollment, e os comandos patients, exams e files seguem a partir daí.
-
diagnos-api
Uma fachada REST fina sobre o mesmo SDK, para equipas que falam HTTP em vez de Python — autenticada apenas por certificado mTLS.
Nós adoramos código aberto
A licença permite utilização comercial, modificação e redistribuição livres, com concessão expressa de patente — a única contrapartida é preservar o aviso de direitos de autor e assinalar as alterações feitas. Não prometemos suporte, roteiro público nem processo de aceitação de contribuições: é código aberto, não um produto com contrato de suporte.
Repositório público diagnos-tech/integration
Mãos à obra
Início rápido
Escolha o pacote e o método de instalação — os comandos abaixo são exatamente os que os READMEs do repositório confirmam.
Todo comando abaixo precisa de um DIAGNOS_API_TOKEN, emitido por um administrador do workspace. Como obter
bash
pip install diagnospython
from diagnos import Diagnos
with Diagnos() as vault:
for row in vault.patients.list():
patient = vault.patients.get(row.document_id)
print(patient.record.legal_name)bash
pip install "diagnos @ git+https://github.com/diagnos-tech/integration@develop#subdirectory=apps/sdk"python
from diagnos import Diagnos
with Diagnos() as vault:
for row in vault.patients.list():
patient = vault.patients.get(row.document_id)
print(patient.record.legal_name)Compila o enclave em Rust durante a instalação — exige cargo e rustup no PATH.
bash
git clone https://github.com/diagnos-tech/integration && cd integration
make sync
make checkCompila o enclave em Rust durante a instalação — exige cargo e rustup no PATH.
bash
pipx install diagnos-clibash
diagnos loginbash
diagnos --json patients list --group sg_oncology | jq '.items[].document_id'A sessão nunca fica gravada em disco: sem o OpenBao configurado, cada nova invocação faz o enrollment outra vez.
bash
pipx install "diagnos-cli @ git+https://github.com/diagnos-tech/integration@develop#subdirectory=apps/cli" \
--preinstall "diagnos @ git+https://github.com/diagnos-tech/integration@develop#subdirectory=apps/sdk"bash
diagnos loginbash
diagnos --json patients list --group sg_oncology | jq '.items[].document_id'A sessão nunca fica gravada em disco: sem o OpenBao configurado, cada nova invocação faz o enrollment outra vez.
bash
docker build -f apps/api/Dockerfile -t diagnos-api .bash
docker run --rm -p 8443:8443 --cap-add=IPC_LOCK \
-e DIAGNOS_API_TOKEN=apikey-… \
-e DIAGNOS_API_MTLS_CA_FILE=/certs/clients-ca.pem \
-e DIAGNOS_API_TLS_CERT_FILE=/certs/server.pem \
-e DIAGNOS_API_TLS_KEY_FILE=/certs/server-key.pem \
-v $PWD/certs:/certs:ro diagnos-apiO --cap-add=IPC_LOCK permite ao enclave em Rust bloquear as chaves na RAM para além dos 64 KiB predefinidos; sem ele, o contentor arranca em modo best-effort.
bash
cd apps/api/deploy/compose
cp .env.example .env
docker compose upSobe o OpenBao e a API juntos, no mesmo compose.
bash
kubectl apply -k apps/api/deploy/k8sUma réplica só: a sessão do SDK é por processo. Escalar exige OpenBao e uma service account por réplica.
Controlo de acesso
Os pacotes são públicos. O token, não.
DIAGNOS_API_TOKEN identifica uma service account e o respetivo workspace, e é emitido por um administrador do workspace. Sozinho, não desbloqueia nada — quem desbloqueia é a aprovação humana dos três passos abaixo.
O que a referência completa da API cobre
- Especificação OpenAPI 3.1
- Autenticação por bearer token
- Ambientes de sandbox e produção
A referência completa é pública — aceda pelo repositório no GitHub ou pela documentação abaixo, sem pedir aprovação a ninguém. Para autenticar as chamadas, crie um DIAGNOS_API_TOKEN em Definições → Contas de serviço, dentro do seu workspace.
ou escreva para [email protected]
Zero trust
Integração com segurança de ponta a ponta
Nenhum processo lê nada sozinho: o enrollment troca chaves e espera que alguém aprove — na hora, ou antes.