Este repositório apresenta uma aplicação desenvolvida para validar CPFs utilizando Azure Functions. O projeto faz uso do Azurite, que emula localmente os serviços de armazenamento do Azure (Blob, Queue e Table), permitindo um ambiente de desenvolvimento controlado e seguro.
- Introdução
- Configuração do Ambiente
- Estrutura do Projeto
- Testando com o Postman
- Boas Práticas Adotadas
- Referências
Este projeto tem como objetivo implementar e validar CPFs de forma prática e eficiente utilizando Azure Functions. A configuração local do Azurite garante que você possa simular o ambiente de produção em sua máquina.
-
Instale o Azurite:
npm install -g azurite azurite
-
Configure o arquivo
local.settings.json:{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "dotnet" } }Nota: Não inclua este arquivo no controle de versão para evitar expor informações sensíveis.
-
Atualize o
.gitignore:# Azure Functions local.settings.json # Azurite database files __blobstorage__/ _azurite_db_* # VS Code settings (opcional) .vscode/ # Build outputs bin/ obj/
-
Remova arquivos já rastreados (se necessário):
git rm --cached local.settings.json git rm --cached -r __blobstorage__ git commit -m "Removendo arquivos sensíveis do rastreamento"
O projeto está organizado da seguinte forma:
AzureFunctionsLearn/
├── validarCPF/
│ ├── host.json
│ ├── local.settings.json (ignorado pelo Git)
│ ├── validarcpf.cs
│ ├── __blobstorage__/ (ignorado pelo Git)
│ └── validarCPF.csproj
└── .gitignore
Você pode validar CPFs através da Azure Function utilizando o Postman. Siga os passos abaixo:
-
Configurar a Requisição:
- Método:
POST - URL:
http://localhost:<porta_da_function>/api/validarcpf - Corpo (JSON):
{ "cpf": "12345678909" }
- Método:
-
Adicionar Chave de Acesso (se aplicável): Caso a função exija autenticação, inclua a chave no parâmetro
codeda URL ou utilize o cabeçalhox-functions-key. -
Enviar a Requisição:
- Clique em "Enviar" no Postman e confira a resposta.
-
CPF Válido:
{ "status": "success", "message": "O {cpf} é válido e pode ser utilizado!" } -
CPF Inválido:
{ "status": "error", "message": "CPF INVÁLIDO!!!" }
-
Proteção de Informações Sensíveis:
- O arquivo
local.settings.jsone os diretórios do Azurite foram configurados para serem ignorados no Git.
- O arquivo
-
Uso de Variáveis de Ambiente:
- Em produção, dados confidenciais devem ser armazenados como variáveis de ambiente.
-
Validação Pré-Publicação:
- A estrutura do projeto foi revisada para garantir que informações sensíveis não sejam publicadas.