npm.io
1.1.14 • Published 4 years ago

insomnia-plugin-mastercard-auth

Licence
Apache-2.0
Version
1.1.14
Deps
3
Size
29 kB
Vulns
0
Weekly
0
Stars
51
DeprecatedThis package is deprecated
SummaryDependencyVersions

insomnia-plugin-mastercard

Table of Contents

Overview

A plugin for handling Mastercard API authentication. This plugin computes and adds an Authorization header to requests sent from Insomnia REST Client.

Compatibility

Insomnia v5.15.0+

References

Usage

Prerequisites

Before using this library, you will need to set up a project in the Mastercard Developers Portal.

As part of this set up, you'll receive credentials for your app:

  • A consumer key (displayed on the Mastercard Developer Portal)
  • A private request signing key (matching the public certificate displayed on the Mastercard Developer Portal)
Installation
1. One-Click Installation
  1. Go to https://insomnia.rest/plugins/insomnia-plugin-mastercard-auth
  2. Click the "Install Plugin" button
  3. Click "Open Insomnia" and "Install"
2. From the Plugins Tab
  1. Open Insomnia
  2. Go to Application > Preferences > Plugins
  3. Type "insomnia-plugin-mastercard-auth"
  4. Click "Install Plugin"

3. Manual Installation
  1. Download "insomnia-plugin-mastercard-auth-{version}.zip" from Releases > Assets
  2. Go to Application > Preferences > Plugins
  3. Click "Reveal Plugins Folder"
  4. Extract the ZIP file from step 1 to the "plugins" folder
  5. Click "Reload Plugins"

Configuration
One-Click Import

To import two ready to be used "sandbox" and "production" environments:

  1. Click
  2. Click "Run Import Mastercard Workspace"

Alternatively, you can:

  1. Go to Application > Preferences > Data
  2. Click "Import Data"
  3. Click "From URL"
  4. Type: https://raw.githubusercontent.com/Mastercard/insomnia-plugin-mastercard-auth/master/workspace/mastercard-apis-insomnia-workspace.json
  5. Click "Fetch and Import"

Manual Configuration

Update your environment:

  1. Click "Manage Environments"
  2. Create a "mastercard" environment variable with your credentials:

Linux/macOS

{
  "mastercard": {
    "consumerKey": "000000000000000000000000000000000000000000000000!000000000000000000000000000000000000000000000000",
    "keyAlias": "keyalias",
    "keystoreP12Path": "/path/to/sandbox-signing-key.p12",
    "keystorePassword": "keystorepassword",
    "appliesTo": [
      "mastercard.com",
      "api.ethocaweb.com"
    ]
  }
}

Windows

{
  "mastercard": {
    "consumerKey": "000000000000000000000000000000000000000000000000!000000000000000000000000000000000000000000000000",
    "keyAlias": "keyalias",
    "keystoreP12Path": "C:\\path\\to\\sandbox-signing-key.p12",
    "keystorePassword": "keystorepassword",
    "appliesTo": [
      "mastercard.com",
      "api.ethocaweb.com"
    ]
  }
}
Authenticated Requests

From now on, an Authorization header will be automatically added to every request sent to Mastercard:

Further Reading