Single sign-on (SSO) is a way to control access to multiple independent pieces of software. Basically, SSO lets you use separate tools that require user authorization (logging in with a username and password) without having to sign in to each of them: SSO takes care of the user authorization process, so you only have to log in once.
From version 7.5 on, codeBeamer ALM supports the zse of SSO (using LDAP) to integrate the ALM platform with other tools via REST API. Regardless of what (and how many) other tools your team is using, their authorization can be managed with minimal effort, saving you time and enhancing security.
Benefits of SSO
In addition to being highly convenient, single sign-on also results in increased security. With SSO, there is no need for a login interface, so your account is safe even if your password gets into the wrong hands.
Not only is codeBeamer a flexible tool that can be fully customized and configured to suit the needs of your organization, it is also easy to integrate in your preexisting workflow. In addition to out-of-the-box integrations, REST API allows you to extend codeBeamer's functionality with any number of tools. From version 7.5 up, codeBeamer can also be configured to handle SSO, and single sign-on can also be used for applications your team is developing to improve their workflows.
Below, you'll find an example of a REST API application based on .NET using SSO that can be used to fetch all unresolved issues assigned to a certain user.
>CodeBeamerUnresolvedIssues.exe -e [enpoint] -u [username] -p [password] -a [user account] -t [type] -f [file name]
-c [converter] -n [encoding] -o -d
-u [Username]: login user account name, default is current Windows user
-p [Password]: login user password, if no value specified then Windows session authentication is used
-e [Endpoint]: the codeBeamer endpoint server address (eg. https://codebeamer.com/cb)
-a [user Account]: (optional) List the specified user's work items, by default the login user's work items are listed
-t [Type]: (optional) Result file format. Possible values: tsv, csv, json, xml. Default: tsv
-f [File name]: (optional) Generate the result into the specified file
-c [Converter]: (optional) Use special item converter (ext is implemented for now)
-n [eNcoding]: (optional) Output encoding (the list of usable encoding could be found in msdn,
-o [Only directly assigned]: (optional) Show only the directly related work items to the user (not related via the user's role
-d [Debug]: (optional) debug mode on
CodeBeamerUnresolvedIssues.exe -e https://codebeamer.com/cb -u cbprojectadmin -p cbpass -a cbdeveloper -t json -f result.json -c ext -n windows-1250 -o -d
This will fetch unresolved issues which directly assigned (-o) to user "cbdeveloper" (-a) using codeBeamer REST API. The request authenticate with "cbprojectadmin",
"cbpass" pair (-u,-p), the type will be JSON (-t), and the result will be generated into (-f) a file called "result.json",
and an extended item converted will be used (-c). The result encoding will be windows-1250. Extra information about the execution will be printed (-d).
CodeBeamerUnresolvedIssues.exe -e https://codebeamer.com/cb -u cbprojectadmin -p cbpass
This will fetch all unresolved issues for user "cbprojectadmin" (-a not specified),
and it will print out the result in tsv format (-t not specified, tsv is the default) to console output (-f not specified, default is the console)
in UTF8 encoding (-n not specified, UTF8 is the default output encoding)
Fore more examples on using REST API with SSO, please see the relevant section in our Knowledge Base: Example Rest API client based on .NET
codeBeamer can be simply and efficiently integrated to your current workflow via REST API. When configuring codeBeamer with SSO (using LDAP), the integration is convenient and secure as user authorization is automatically taken care of in the background. To learn more, contact our sales team, or start your free trial of codeBeamer ALM today!