An environment is a reference to an instance of the integration engine. These could be multiple instances of the same integration engine, for example "stage" and "prod" environments. While not likely to be made up of many entries, your list of environments is effectively a registry of integration platforms, whether homegrown or commercially available, that will move data on your end users behalf.
name: The name for this environment, e.g. "stage", "prod", "test"
description: A description of the environment
users: Information about the users within an environment. See below
components: See below
serviceURLs: See below
components property is an object that maps a component name to a component id within a particular OIH instance. This allows a template author to reference the functionality of a component without having to know ahead of time that component's environment-specific id. A component name
jsonata, for example, could refer to a component that performs a JSONata transformation on its input.
serviceURLs property is an object that maps OIH services to their public endpoints for a particular OIH instance. In order for Doohickey to interact with OIH it must know which URLs to use. Thus setting the
iam url to
https://iam.example.com tells Doohickey to use that URL for API calls related to the Identity Access Management service (IAM).
Important: When creating a tenant for a specific environment, the tenant API will expect to find an
admin user within the
users object. This
admin user will be used to create and modify tenants in the OIH environment.