insomnia-plugin-mastercard-auth

insomnia-plugin-mastercard

Table of Contents

• Overview
  • Compatibility
  • References
• Usage
  • Prerequisites
  • Installation
  • Configuration
  • Authenticated Requests
• Further Reading

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

• Using OAuth 1.0a to Access Mastercard APIs
• A Mastercard Plugin for Insomnia REST Client

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

• Go to https://insomnia.rest/plugins/insomnia-plugin-mastercard-auth
• Click the "Install Plugin" button
• Click "Open Insomnia" and "Install"

2. From the Plugins Tab

• Open Insomnia
• Go to Application > Preferences > Plugins
• Type "insomnia-plugin-mastercard-auth"
• Click "Install Plugin"

3. Manual Installation

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

Configuration

One-Click Import

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

• Click
• Click "Run Import Mastercard Workspace"

Alternatively, you can:

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

Manual Configuration

Update your environment:

• Click "Manage Environments"
• 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

• Insomnia Plugins
• The Insomnia Plugin Hub
• oauth1-signer-nodejs — A zero dependency library for generating a Mastercard API compliant OAuth signature