Search user's Card by user's identity

This guide shows how to get a user's Card from Virgil Cards Service by user's identity and identityType.

Prerequisites for work

Install SDK & Setup Virgil Crypto

The Virgil Ruby SDK is provided as a package named virgil-sdk. The package is distributed via bundler package manager.

The package is available for Ruby 2.1 and newer.

Installing the package:

To install the gem use the command below:

gem install virgil-sdk

or add the following line to your Gemfile:

gem 'virgil-sdk', '~> 4.2.6'

Set up authentication on a client side

In order to make call to Virgil Services, for example, to publish user's Card on Virgil Cards Service you need to have a Access Token. You have to generate for each Application an Access Token on Virgil Dashboard.

With the Access Token we can initialize the Virgil SDK on the client-side to start doing fun stuff like sending and receiving messages.

To initialize the Virgil SDK on a client-side you need to use the following code:

virgil = VirgilApi.new(access_token: "[YOUR_ACCESS_TOKEN_HERE]")

Set up Card Verifier

Virgil Card Verifier helps you automatically verify signatures of a User's Card, for example when you get Card from Virgil Cards Service.

By default, CardVerifiers verifies only two signatures - those of a Card owner and Virgil Cards Service.

Set up CardVerifiers with the following lines of code:

app_public_key = VirgilBuffer.from_base64("[YOUR_APP_PUBLIC_KEY_HERE]")

# initialize High Level Api with custom verifiers
virgil = VirgilApi.new(context: VirgilContext.new(
            access_token: "[YOUR_ACCESS_TOKEN_HERE]",
            card_verifiers: [VirgilCardVerifierInfo.new("[YOUR_APP_CARD_ID_HERE]", app_public_key)])
            )

alice_cards = virgil.cards.find("alice")

Search User's Cards

Use the following code to search Cards on the Virgil Cards Service by identity and identityType:

# search for all Global Virgil Cards
bob_global_cards = virgil.cards.find_global(VirgilIdentity::EMAIL,
 "bob@VirgilSecurity.com")

# search for Application Virgil Card
app_cards = virgil.cards.find_global(VirgilIdentity::APPLICATION, "com.username.appname")