---
title: "Projeto de exemplos em Ruby on Rails"
description: "Projeto de exemplos em Ruby on Rails que usa o Rest PKI com o Web PKI: como executar com bundle install e rails server e onde achar cada recurso."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/ruby/rails"
locale: "pt-BR"
product: "Rest PKI (legado)"
last_updated: "2026-10-12"
---

# Projeto de exemplos em Ruby on Rails

O **Projeto de exemplos em Ruby on Rails** mostra como usar o [Rest PKI](https://docs.lacunasoftware.com/articles/rest-pki) junto com [Web PKI](https://docs.lacunasoftware.com/articles/web-pki) em um projeto de Ruby usando o framework [Ruby on Rails](http://rubyonrails.org/). Isto está hospedado no GitHub em:

https://github.com/LacunaSoftware/PkiSuiteSamples/tree/master/ruby/rails

## Executando o projeto

1. [Download do projeto](https://github.com/LacunaSoftware/PkiSuiteSamples/archive/master.zip) ou clone o [repositório](https://github.com/LacunaSoftware/PkiSuiteSamples.git)
1. Instale as dependências: `bundle install`
1. Execute a aplicação: `rails server`
1. Accesse a URL [http://localhost:3000](http://localhost:3000)

## Mapa do projeto

Esta seção lista onde você vai encontrar partes relevantes nas amostras do projeto.

### Autentificação com certificado digital

* Controller: [AuthenticationRestController](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/controllers/authentication_rest_controller.rb)
* Views:
  * [index.html.erb](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/views/authentication_rest/index.html.erb)
    (JavaScript on [signature-form.js](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/assets/javascripts/signature-form.js))
  * [action.html.erb](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/views/authentication_rest/action.html.erb)

### Assinatura PAdES com arquivo já no servidor

* Controller: [PadesSignatureRestController](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/controllers/pades_signature_rest_controller.rb)
* Views:
  * [index.html.erb](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/views/pades_signature_rest/index.html.erb)
    (JavaScript on [signature-form.js](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/assets/javascripts/signature-form.js))
  * [action.html.erb](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/views/pades_signature_rest/action.html.erb)

### Assinatura PAdES com arquivo enviado pelo usuário

Após o upload do arquivo (apenas para demonstração no controlador [ServerFilesController](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/controllers/server_files_controller.rb) e 
visualização [index.html.erb](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/views/server_files/index.html.erb)) o fluxo de controle é o mesmo que na amostra [Assinatura PAdES com arquivo existente já no servidor](https://docs.lacunasoftware.com/articles/rest-pki/ruby/rails#pades), mas com o parâmetro URL `userfile` preenchido.

### Co-assinatura PAdES

Após o fluxo de controle da amostra [Assinatura PAdES com arquivo já existente](https://docs.lacunasoftware.com/articles/rest-pki/ruby/rails#pades) for concluído e o link *Co-assinar com outro certificado* for clicado, o
mesmo fluxo de controle é repetido, mas agora com o parâmetro de URL `userfile` preenchido.

### Marcas PAdES

Não avaliado para este projeto ainda.

### Assinatura PAdES usando chave do servidor

Não avaliado para este projeto ainda.

### Assinatura PAdES sem comunicação do cliente

* Controller: [PadesSignatureExpressController](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/controllers/pades_signature_express_controller.rb)
* Views:
  *	[index.html.erb](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/views/pades_signature_express/index.html.erb)
	(JavaScript on [signature-start-form.js](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/assets/javascripts/signature-start-form.js))

### Abrir/validar uma assinatura PAdES existente

Não avaliado para este projeto ainda.

### Versão para impressão

Não avaliado para este projeto ainda.

### Assinatura CAdES com arquivo já no servidor

* Controller: [CadesSignatureController](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/controllers/cades_signature_controller.rb)
* Views:
  * [index.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/cades_signature/index.html.erb)
    (JavaScript on [signature-form.js](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/assets/javascripts/signature-form.js))
  * [action.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/cades_signature/action.html.erb)

### Assinatura CAdES com arquivo enviado pelo usuário

Após o upload do arquivo (implementado de forma rudimentar, apenas para fins de demonstração, no controller
[ServerFilesController](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/controllers/server_files_controller.rb)
e na view
[index.html.erb](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/app/views/server_files/index.html.erb)),
o fluxo de controle é o mesmo da amostra [Assinatura CAdES com arquivo já no servidor](https://docs.lacunasoftware.com/articles/rest-pki/ruby/rails#cades), mas com o parâmetro de URL `userfile` preenchido.

### Assinatura conjunta CAdES

Após o fluxo de controle da amostra [Assinatura CAdES com arquivo já no servidor](https://docs.lacunasoftware.com/articles/rest-pki/ruby/rails#cades) ser concluído e o link *Co-sign with another certificate* for clicado, o
mesmo fluxo de controle é repetido, mas agora com o parâmetro de URL `userfile` preenchido.

### Assinatura CAdES usando chave do servidor

Não avaliado para este projeto ainda.

### Abrir/validar uma assinatura CAdES existente

Não avaliado para este projeto ainda.

### Assinatura XML de um documento inteiro

* Controller: [FullXmlSignatureController](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/controllers/full_xml_signature_controller.rb)
  * [index.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/full_xml_signature/index.html.erb)
    (JavaScript on [signature-form.js](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/assets/javascripts/signature-form.js))
  * [action.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/full_xml_signature/action.html.erb)

### Assinatura XML de um elemento

* Controller: [XmlElementSignatureController](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/controllers/xml_element_signature_controller.rb)
* Views:
  * [index.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/xml_element_signature/index.html.erb)
    (JavaScript on [signature-form.js](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/assets/javascripts/signature-form.js))
  * [action.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/xml_element_signature/action.html.erb)

### Assinatura XAdES de um elemento

Não avaliado para este projeto ainda.

### Abrir/validar assinaturas em um arquivo XML existente

Não avaliado para este projeto ainda.

### Lote de assinaturas PAdES

* Controller: [BatchSignatureController](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/controllers/batch_signature_controller.rb)
* View: [index.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/batch_signature/index.html.erb)
  (JavaScript on [batch-signature-form.js](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/assets/javascripts/batch-signature-form.js))

### Lote otimizado de assinaturas PAdES

Não avaliado para este projeto ainda.

### Lote de assinaturas CAdES

* Controller: [CadesBatchSignatureController](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/controllers/cades_batch_signature_controller.rb)
* View: [index.html.erb](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/views/cades_batch_signature/index.html.erb)
  (JavaScript on [batch-signature-form.js](https://github.com/LacunaSoftware/RestPkiSamples/blob/master/Ruby/app/assets/javascripts/batch-signature-form.js))

### Lote de assinaturas XML de elementos do mesmo documento

Não avaliado para este projeto ainda.