BMC Common React Components

A library of React components for use in applications at BMC

Installation

Run the following command: yarn add react-bmc-common

Setup Scoped Package Repository

The .yarnrc file needs to be in place with a scoped package repository reference to the gemfury repository.

"@bmc:registry" "https://npm.fury.io/bmc/"

Publishing a New Version

First, you need to build the distributable package:

yarn build

Then you should be able to run

yarn publish

Note: You may be required to authenticate by running:

yarn login --registry="https://npm.fury.io/bmc/"

Upgrading the Libraries

yarn upgrade-interactive

Bumping the version number

yarn version --patch

or

yarn version --minor

Okta Setup

Implicit Flow

Don't use this. Produces a "thin" token. This doesn't provide group claims. So, it can't be used for this library.

Note: This would change if we added the authorization server package to our Okta plan.

Authorization Code with Hybrid Implicit Flow

This is the setup that you must use for the groups claim to be returned.

Okta App General Settings Example

Okta App Sign On Settings Example

Note the use of the Groups claim filter.

To Do

• Move the react code to use function style components with hooks. This will simplify the lifecycle methods.
• Investigate whether we can eliminate the custom login page, redirect to Okta's login, and still get a token that can be used for authorization.