Skip to end of metadata
Go to start of metadata

Description

Coupa Connector for midPoint is based on Evolveum's REST connector template.

ProtocolREST https://coupadocs.atlassian.net/wiki/display/integrate/Coupa+API
SecurityHTTPS
FrameworkPolygon 1.4.2.14
Connector namecom.evolveum.polygon.rest.CoupaRestConnector
LicenceApache 2.0
Sourcehttps://github.com/Evolveum/connector-coupa

Status

MidPoint version

Connector requires midPoint 3.5 or newer.

Coupa Connector is intended for production use. The connector was introduced as a contribution to midPoint project by AMI Praha and is not officially supported by Evolveum.

Coupa Connector contains support for USER and ROLE. The current focus is on USER entity.

Overview

Coupa procurement software as a service. This connector uses the Coupa's REST API to add, modify and disable user accounts and assign roles. 

More information on Coupa can be found here.

Supported operations

  • Test
  • Schema (static)

for USER entity:

  • Search
    • By login
    • By id
  • Create
  • Update
  • Delete (as disable)

for ROLE entity:

  • Search
    • By name
    • By id

Supported attributes

for USER entity:

  • id
  • login
  • active
  • purchasing-user
  • authentication-method
  • sso-identifier
  • email
  • firstname
  • lastname
  • roles
  • default-locale
  • default-address

for ROLE entity:

  • id
  • name
  • description
  • omnipotent
  • system-role

Configuration

Configuration PropertyRequiredTypeDefault ValueDescriptionValue example
Test user loginXString Login of test user for test connection method. For example username@domain.comusername@domain.com
Token nameXString Name of the token attribute in REST requestX-COUPA-API-KEY
Service addressXString hostname of coupa REST api endpointhttps://company.coupahost.com/api
Token valueXString security token allowing to connect to coupa(random string generated by coupa)
Default page size String10Size of the default response page when requesting objects from coupa (max 50 recommended 10)10
Delete role assignments Boolean flag whether to delete all assignments when assigning new roles to the user. (default true, false allows only adding new assignments)true

Getting started

Building the connector

Download and build the project with usual:

 

mvn clean install

 

Import connector JAR file to one of these locations:

  • midPoint WEB-INF/lib
  • the application server (e.g. Tomcat) lib directory
  • the icf-connectors directory in midPoint home

Restart midPoint

Creating resource

  • Click new resource in resource sub menu of midpoint administration GUI
  • Set correct connector and some descriptive name
  • fill configuration attributes as described higher in the Configuration section

Configuring resource

  1. Obtain coupa api token from coupa
  2. Obtain username of one user which will be searched during test connection operation
  3. Set all other attributes according to examples



 

 

 

  • No labels