Adding a Swagger definition as a synchronization source
You can add a Swagger definition to automatically create the resources that are required
for testing the API that the definition describes.
About this task
Security information about basic-authentication and API-keys in Swagger
definitions are included when you synchronize.
- Basic Authentication
- An HTTP transport is created with Basic Authentication enabled.
- API key
- After you synchronize with the Swagger definition that defines at least one API key, an
environment tag is created for each API key security scheme. Each created tag's usage depends on the
security scheme in property header or query.
- A header field is created in the associated operation with the environment tag as the fields default value.
- A query segment is created in the produced rest schema with the environment tag as the default value.
- OAuth2
- Not supported.
Procedure
- Launch the Create a new Synchronization Source wizard in one of the
following ways:
- On the toolbar of the Synchronization view of the Architecture School perspective , click .
- Click the Create Synchronization Source icon (
) and select Swagger Definition from
the Type list. - Paste a URL or file location that points to a Swagger definition into the workspace for the
Logical View.Note: If you are browsing to find a Swagger definition file with an extension other than swagger, make sure you select All Files for the file type.
- Complete the information on the first page of the Create a new Synchronization
Source wizard that is unique to the Swagger source. That information consists of the location for the definition file to use as a sync source. In the Location field enter a URL that points to a Swagger definition file, or click Browse to find a Swagger definition file on your local network, or click Registry to find a Swagger document in a Service Registry by providers such as IBM API Connect. The Swagger definition can be in either JSON or YAML format.
Browse to display a list of identities. To add an identity to a Swagger document, see Adding an identity to the Physical view.