Pular para o conteúdo principal

Perfil

Em Perfil você consulta seus dados e ajusta o que vale para a organização: os binários padrão dos modelos, as chaves de acesso à API, a integração com a Tempo OK e o webhook de avisos. Abra a tela clicando no seu nome, no pé do menu lateral.

O topo mostra Email, Nome, Organização e Membro desde. Se faltar algum arquivo obrigatório para executar, como um binário ou uma licença, a seção Pré-requisitos do ambiente lista o que falta; use Atualizar verificação depois de corrigir.

Binários padrão da organização​

Escolha o executável de NEWAVE, DECOMP, DESSEM e GEVAZP usado quando uma rodada não tem um binário específico. A escolha vale para todos os usuários da organização.

  1. Em cada modelo, selecione uma das versões cadastradas para a organização.
  2. Clique em Salvar binários padrão.

Para remover o padrão de um modelo, selecione Nenhum binário padrão.

Chaves de API​

As chaves dão acesso à API para usuários.

  1. Em Chaves de API, clique em Minhas chaves.

  2. Em Nova chave, informe um Nome que identifique o uso, como o sistema que vai chamar a API.

  3. Em Expiração, escolha a data final ou deixe em branco para usar a validade padrão de 90 dias.

  4. Marque os escopos. Ler estudos e Criar/importar estudos já vêm marcados; marque só o que a integração precisa.

    EscopoPermite
    studies:readLer estudos
    studies:writeCriar e importar estudos
    executions:readLer execuções
    executions:writeDisparar execuções
    webhooks:readLer a configuração e as entregas de webhook
    webhooks:writeAlterar e reenviar webhooks

  5. Clique em Criar chave e copie o valor mostrado em Segredo criado. Ele não aparece de novo.

A tabela Chaves mostra nome, prefixo, escopos, estado, data de expiração e último uso. Clique em Revogar para cortar o acesso de uma chave na hora. Uma chave revogada ou expirada não volta a funcionar: crie outra.

Administradores da organização veem também Chaves da organização, com as chaves de todos os membros, filtro por estado (Ativas, Expiradas, Revogadas) e a opção de revogar qualquer uma.

Integração Tempo OK​

A chave da Tempo OK permite baixar PREVS e DADVAZ na tela TOK.

  1. Cole a chave em Chave Tempo OK.
  2. Clique em Testar para conferir o acesso sem salvar.
  3. Clique em Salvar integração.

Ao salvar, o Myria valida a chave. O estado aparece abaixo do campo: Acesso ativo ou Sem acesso, com a data da última validação. Para remover a integração, apague a chave e salve.

Webhooks​

O webhook envia avisos para um endereço da sua organização. A URL precisa usar HTTPS e estar acessível pela internet.

  1. Informe a URL do webhook.
  2. Em Eventos, marque Mapas TOK baixados e/ou Rodadas concluídas ou com falha. Os eventos TOK só ficam disponíveis com uma chave Tempo OK validada.
  3. Clique em Salvar webhook.

Depois de salvo, aparece o Segredo de assinatura; use Mostrar para copiá-lo e validar os avisos no seu sistema. Gerar novo segredo troca o segredo: atualize-o no seu sistema logo em seguida.

Cada aviso é um POST com corpo JSON {id, type, created_at, organization: {id, slug, name}, data}. O type é tok.downloaded (mapa TOK baixado) ou rodada.finished (rodada concluída ou com falha). Os cabeçalhos são X-Myria-Event, X-Myria-Delivery, X-Myria-Timestamp e X-Myria-Signature. Para validar, calcule o HMAC SHA-256 de timestamp + "." + corpo com o segredo e compare com o valor de X-Myria-Signature (sha256=<hex>). Cada tentativa leva timestamp e assinatura novos; use o id do corpo para descartar avisos repetidos. Respostas fora de 2xx contam como falha e o aviso é reenviado mais tarde.

Em tok.downloaded, o campo data.map_kind identifica o pacote baixado: prevs, vazpast ou dadvaz. Para DADVAZ, data.repository_path aponta para a captura em terceiros/tok/dadvaz/; files_downloaded conta os arquivos diários publicados, sem o marcador de conclusão.

Os avisos do Perfil são diferentes do webhook da API, que tem outros eventos e outro formato (Webhooks). Configurar o webhook pela API substitui a URL e o segredo daqui e desliga estes avisos.

Problemas comuns​

“Revise os binários padrão selecionados.” Uma das versões escolhidas não é mais válida para o modelo. Escolha outra versão da lista.

“Integração salva. Token Tempook sem acesso”. A chave foi salva, mas a Tempo OK recusou o acesso. Confira a chave e a assinatura com a Tempo OK.

“Integração salva. Não foi possível validar o token Tempook no momento”. A Tempo OK não respondeu. A chave fica salva; use Testar mais tarde. Com a Checagem ativa na tela TOK, o Myria também tenta validá-la de novo a cada intervalo.

“Revise a configuração do webhook.” Confira se a URL começa com https:// e aponta para um endereço público.

A lista de binários está vazia. Nenhuma versão foi cadastrada para a sua organização. Fale com a equipe Myria.