Sha256: e2fad5ad8081811b219addfd7753ca39994f3fda763e80abf2c7089101f77adc

Contents?: true

Size: 1.72 KB

Versions: 9

Compression:

Stored size: 1.72 KB

Contents

# FusionAuth::FusionAuthClient

This gem is the Ruby client library that helps connect Ruby applications to the FusionAuth (https://fusionauth.io) Identity and User Management platform.

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'fusionauth_client'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install fusionauth_client

## Usage

Once the gem is installed, you can call FusionAuth APIs like this:

```ruby
require 'fusionauth/fusionauth_client'

# Construct the FusionAuth Client
client = FusionAuth::FusionAuthClient.new(
    '<YOUR_API_KEY>', 
    'http://localhost:9011'
)

# Create a user + registration
id = SecureRandom.uuid
client.register(id, {
    :user => {
        :firstName => 'Ruby',
        :lastName => 'Client',
        :email => 'ruby.client.test@fusionauth.io',
        :password => 'password'
    },
    :registration => {
        :applicationId => application_id,
        :data => {
            :foo => 'bar'
        },
        :preferredLanguages => %w(en fr),
        :roles => %w(user)
    }
})

# Authenticate the user
response = client.login({
    :loginId => 'ruby.client.test@fusionauth.io',
    :password => 'password',
    :applicationId => application_id
})
user = response.success.response.user
```

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/FusionAuth/fusionauth-ruby-client. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.


## License

The gem is available as open source under the terms of the [Apache v2.0 License](https://opensource.org/licenses/Apache-2.0).

Version data entries

9 entries across 9 versions & 1 rubygems

Version Path
fusionauth_client-1.23.0 README.md
fusionauth_client-1.22.2 README.md
fusionauth_client-1.22.1 README.md
fusionauth_client-1.22.0 README.md
fusionauth_client-1.21.0 README.md
fusionauth_client-1.20.1 README.md
fusionauth_client-1.20.0 README.md
fusionauth_client-1.19.0 README.md
fusionauth_client-1.18.0 README.md