Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Steps to setting up MOD-NCIP (also see the MOD-NCIP readme file in github)

...

Step #1 - create a user with the required permissions

  • Create User User → The user has to be assigned a patron group.  There is an issue with 'create item' which requires the user to be assigned a patron group.
  • Use the reset password link to create a password

...

  • If you are using the edge-ncip module to allow external access to mod-ncip you will have to create a key that relates to this user.  See the edge-common module for more details.  What you will end up with is an API key you can use to represent this user.  You will be able to provide whomever will be calling your NCIP module externally with a link that will look something like this:   http://thedirecturltomyexternalncipmodule/ncip?apikey=eyJzIjoiSkFucGg0Wmw2OFd4ZkRBdnabcedefsgeJ1IjoibXlsdWlkIn0    The key can also be sent through in the header of the requests.  The edge-common module documentation describes the ways you can use the apiKey.  The apiKey is the method of authentication for external users of your NCIP module.

Step #2 - Decide on and set up configuration values.

...

Mod-NCIP includes a utility to validate the configuration values are valid.  If you send a GET request to: http://myokapiurl/ncipconfigcheck  it will attempt to lookup the values you set in mod-configuration to make sure those values exist in FOLIO (for those that need to exist in FOLIO).


There are example NCIP requests in github (note: they use the fromAgency of Relais) and lots more information about the module in the github readme file.

...