Skip to main content
In some cases, services to be provided to clients may need to be opened and/or used through a contract/protocol. In such cases, it may be necessary to keep the contract/protocol text with its history and know which services and credentials are associated with this contract/protocol.
When the Contracts/Protocols page is first entered, all existing contract/protocol records are listed as shown in the image below: Contracts/Protocols List To create a new contract/protocol, press the Create button in the upper right corner and complete the contract/protocol record by saving the information shown in the image below. Or to create a new contract/protocol based on settings from an existing contract/protocol, click the Add a Contract option from the detail menu of the record. Adding Contract/Protocol An image containing Contract/Protocol settings is shown below: Contract/Protocol Settings The fields used for contract/protocol configuration are shown in the table below.
FieldDescription
NameThe name given to the contract/protocol.
DescriptionDescription information can be optionally entered to describe what the contract/protocol contains.
Direction (Direction)Expresses the usage type of services (API Proxies) that are the subject of the contract. When evaluating this field, the relationship of the organization that owns Apinizer with the relevant services should be considered.

If the organization has created the service, Publisher, if the organization is opening an existing service for use by its internal applications, Consumer, if both are the case, Publisher and Consumer option can be selected. If none is desired to be selected, Unspecified expression should be used.
Start Date (Start Date)The start time information of the contract.
End Date (End Date)The end time information of the contract.
Use End Date for Credentials (Use End Date for Credentials)When this option is activated, the usage permission of credentials associated with the contract/protocol automatically expires when the contract period expires and they can no longer make new requests.

Of course, for this setting to be valid, one of the authentication policies must be added on the associated API Proxy and the Security Manager option must be selected as the authentication method in this policy.
Stop Access on End Date of Contract for API Proxies (Stop Access on End Date of Contract for API Proxies)When this option is activated, the usage permission of API Proxies associated with the contract/protocol automatically expires when the contract period expires and they can no longer make new requests.

Of course, for this setting to be valid, one of the authentication policies must be added on the associated API Proxy and the Security Manager option must be selected as the authentication method in this policy.
Status (Status)Information about whether the contract is active or inactive.
Organization (Organization)Information about which organization the contract was made with.

Files Tab

If it is desired for documents related to the contract/protocol to be included within the contract/protocol record, press the Add button marked in red in the image above and save the file to the contract/protocol by entering the necessary information shown in the image below. Adding Contract/Protocol File The fields used for file configuration are shown in the table below.
FieldDescription
Status (Status)Expresses the status of the file.
DescriptionThis field can be used if a description about the file content is desired to be entered.
Select File (Select File)The file to be uploaded
## API Proxies Tab
If it is desired for API Proxies related to the contract/protocol to be included within the contract/protocol record, press the Add button marked in red in the image below. API Proxies Tab When the Add button is pressed, API Proxies within the project are listed as shown in the image below. API Proxy List API proxies for which a relationship with the contract is desired to be established are selected from this list and saved.

Credentials Tab

If it is desired for credentials related to the contract/protocol to be included within the contract/protocol record, press the Add button marked in red in the image below. Credentials Tab When the Add button is pressed, the credential list within the project or defined globally is listed as shown in the image below. Adding Credential List Credentials for which a relationship with the contract is desired to be established are selected from this list and saved. If the desired credential is not in this list, a new credential can be created by pressing the Create button.
For more detailed information about the credential screen, you can visit the Credential Management page.

Previous Contracts Tab

This section contains the list of contracts/protocols from which the current contract/protocol was derived. Previous Contracts Tab