---
title: "Usando o PKI Express em Ruby"
description: "Como usar o PKI Express em Ruby: projeto de exemplos com Ruby on Rails e Web PKI no GitHub, e como executá-lo com bundle install e rails server."
canonical: "https://docs.lacunasoftware.com/articles/pki-express/ruby"
locale: "pt-BR"
product: "PKI Express"
last_updated: "2026-10-12"
---

# Usando o PKI Express em Ruby

Este artigo mostra como usar o [PKI Express](https://docs.lacunasoftware.com/articles/pki-express) em Ruby

## Projeto de exemplos

O projeto de exemplos demonstra o uso de PKI Express junto com o componente [Web PKI](https://docs.lacunasoftware.com/articles/web-pki)
em um projeto **Ruby** usando o framework [Ruby on Rails](http://rubyonrails.org/). Ele encontra-se hospedado no GitHub:

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

### Executando o projeto

1. [Instale o PKI Express](https://docs.lacunasoftware.com/articles/pki-express/setup)
1. [Baixe o projeto](https://github.com/LacunaSoftware/PkiSuiteSamples/archive/master.zip) ou faça um *clone* do [repositório](https://github.com/LacunaSoftware/PkiSuiteSamples.git)
1. Em um terminal, navegue ate a pasta `ruby/rails` e execute o comando `bundle install` para baixar as dependências do projeto.
1. Execute a aplicação web: `rails server`
1. Acesse a URL: [http://localhost:3000](http://localhost:3000)

## Biblioteca do cliente

Para usar o PKI Express em aplicações Ruby, use nosso **Ruby Gem** [pki_express](https://rubygems.org/gems/pki_express) declarando em seu `Gemfile`:

```gemspec
gem 'pki_express', '~> 1.3.2'
```

Após isso, faça um `bundle install` para baixar o gem e suas dependências (se você não tiver o Bundler instalado, pegue [aqui](http://bundler.io/))

Como alternativa, você pode instalar o gem diretamente na linha de comando:

```sh
gem install pki_express
```

> **Observação**
>
> As versões 1.3.2 e anteriores do gem chamam `File.exists?`, que o Ruby 3.2 removeu. No Ruby 3.2 ou superior, restaure esse
> método antes da primeira chamada ao PKI Express, por exemplo num initializer, como faz o
> [projeto de exemplos em Rails](https://github.com/LacunaSoftware/PkiSuiteSamples/blob/master/ruby/rails/config/initializers/pki_express_ruby32_compat.rb):
>
> ```ruby
> File.singleton_class.send(:alias_method, :exists?, :exist?) unless File.respond_to?(:exists?)
> ```

O gem é código aberto, hospedado no [GitHub](https://github.com/LacunaSoftware/PkiExpressRuby). Sinta-se à vontade para fazer o *fork* do repositório se precisar de alguma personalização.