Editar no GitHub

Preparando o banco de dados para instalação do Rest PKI Core

Para instalar uma instância on premises do Rest PKI Core, você vai precisar de uma connection string para um dos seguintes SGBDs:

SQL Server

Para usar o SQL Server, você precisará de um banco de dados com:

  • Collation: Latin1_General_100_CI_AI
  • Credenciais correspondentes a um usuário com papel db_owner
Note

Se você preferir operar o Rest PKI Core sem conceder db_owner ao usuário da aplicação, siga as instruções neste artigo

Warning

A collation do banco de dados PRECISA SER Latin1_General_100_CI_AI. Criar o banco de dados com uma collation diferente provavelmente fará com que a instalação falhe!

Se você precisar de ajuda para preparar o banco de dados, siga os passos neste artigo.

Note

Você não precisa seguir estas instruções especifícas. Se você desejar preparar o banco de dados, por exemplo usando recursos avançados como log shipping ou mirroring, você pode fazê-lo, desde que a collation e as permissões sejam observadas.

Para criar o banco de dados, use a seguinte consulta T-SQL (opcionalmente alterando o nome do banco de dados):

USE Master;
CREATE DATABASE RestPkiCore COLLATE Latin1_General_100_CI_AI;
GO

Crie um usuário e associe-o ao papel db_owner:

USE master;
CREATE LOGIN RestPkiCoreAdmin WITH PASSWORD = 'XXXXX';
GO

USE RestPkiCore;
CREATE USER RestPkiCoreAdmin FOR LOGIN RestPkiCoreAdmin;
EXEC sp_addrolemember 'db_owner', 'RestPkiCoreAdmin';
GO

A connection string seria, então:

Data Source=.;Initial Catalog=RestPkiCore;User ID=RestPkiCoreAdmin;Password=XXXXX
Note

Essa connection string presume que o servidor do banco de dados esteja instalado no mesmo servidor que o aplicativo da web. Se este não for o caso, o valor após Data Source= deve ser alterado.

PostgreSQL

A partir da versão 1.12.0 do Rest PKI Core, também é suportado o uso de PostgreSQL. Qualquer uma das versões do PostgreSQL dentro do período de suporte oficial também é suportada (o que, no momento, significa versão 11 ou superior).

Comece criando o banco de dados e um usuário para a aplicação (altere os nomes caso deseje):

postgres=# CREATE DATABASE restpkicore;
CREATE DATABASE
postgres=# CREATE USER restpkicore WITH PASSWORD 'XXXXX';
CREATE ROLE

Em seguida, conecte-se ao banco de dados recém-criado e configure as permissões ao schema public:

postgres=# \connect restpkicore
You are now connected to database "restpkicore" as user "postgres".
restpkicore=# REVOKE ALL ON SCHEMA public FROM PUBLIC;
REVOKE
restpkicore=# GRANT ALL ON SCHEMA public TO restpkicore;
GRANT
restpkicore=# CREATE SCHEMA hangfire;
CREATE
restpkicore=# GRANT ALL ON SCHEMA hangfire TO restpkicore;
GRANT
Note

Por ora, é necessário utilizar um usuário com acesso pleno. Contate-nos se você precisar executar o Rest PKI Core usando um usuário com acesso limitado.

A connection string seria, então, a seguinte (assumindo que você não alterou os nomes do banco de dados e do usuário):

Host=localhost;Database=restpkicore;Username=restpkicore;Password=XXXXX
Note

Essa connection string parte do pressuposto que o SGBD está instalado no mesmo servidor que a aplicação web. Se esso não for o caso, o valor depois de Host= acima teria que ser alterado.

Veja também