Low commit activity in last 3 years
A long-lived project that still receives updates
Official IBM Cloud SDK core library
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 2.2
~> 5.1
 Project Readme

Build Status codecov Gem Version

ruby-sdk-core

This project contains the core functionality used by Ruby SDK's generated by the IBM OpenAPI SDK Generator. Ruby code generated by openapi-sdkgen will depend on the function contained in this project.

Installation

Install the gem:

gem install ibm_cloud_sdk_core

Inside of your Ruby program do:

require "ibm_cloud_sdk_core"

Authentication Types

There are several flavors of authentication supported in this package. To specify the intended authentication pattern to use, the user can pass in the parameter authentication_type. This parameter is optional, but it may become required in a future major release. The options for this parameter are basic, iam, bearer_token and cp4d.

basic

This indicates Basic Auth is to be used. Users will pass in a username and password and the SDK will generate a Basic Auth header to send with requests to the service.

bearer token

This indicates that bearer token authentication is to be used. Users can pass in an bearer_token, and SDK will generate a Bearer Auth header to send with requests to the service.

iam

This indicates that IAM token authentication is to be used. Users can pass in an apikey. The SDK will manage the token for the user and it will generate a Bearer Auth header to send with requests to the service.

cp4d

This indicates that the service is an instance of ICP4D, which has its own version of token authentication. Users can pass in a username and password. If a username and password is given, the SDK will manage the token for the user. A cp4d_url is required for this type. In order to use an SDK-managed token with ICP4D authentication, this option must be passed in.

Issues

If you encounter an issue with this project, you are welcome to submit a bug report. Before opening a new issue, please search for similar issues. It's possible that someone has already reported it.

Open source @ IBM

Find more open source projects on the IBM Github Page

License

This library is licensed under Apache 2.0. Full license text is available in LICENSE.