ISACA

This library helps ease the integration of ISACA web services into your Ruby applications.

Installation

Add this line to your application's Gemfile:

gem 'isaca'

And then execute:

$ bundle

Or install it yourself as:

$ gem install isaca

Usage

Refer to the full documentation on how to use this library. Consider the following authentication example:

# Log the user in and get back a session token
session = Isaca::Request::AuthenticateUser.get('username', 'password')

# Get user information of the current user 
user = Isaca::Request::GetUserDetailsByToken.get(session.value)

# Destroy a user session
Isaca::Request::LogOut.get(session.value) 

Configuration

Configuration of this library is fairly easy -- you just need to use the Isaca.configure block. Consider the following example:

Isaca.configure do |config|
  config.url = 'https://partnerapi.isaca.org:8443/ISACAServices/Service1.svc'
  config.secret_pass = '1234567890ABCDEFGHI'
  config.user_agent = 'my_application'
  config.verify_ssl = false
end

Rails Integration

For Ruby on Rails applications, consider the isaca-rails engine which utilizes this library. Isaca::Rails is intended to give you a jump start on your ISACA integrated Rails applications.

Contributing

This gem is maintained by the CSX development team at ISACA. Contact csx@isaca.org for requests or concerns.