@itentialopensource/adapter-tufin_secureapp

{ "info": { "_postman_id": "b5956db8-8e5a-41b1-a975-6bb4d8f75f6c", "name": "Tufin-SecureApp-R19-2-RC1", "description": "Tufin Orchestration Suite - Tufin SecureChange/SecureApp APIs. For detailed information about the APIs please see the documentation at: https://your-securetrack-server/securechangeworkflow/apidoc", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Access Portal", "item": [ { "name": "Retrieve existing application access requests", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/application_access_requests", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "application_access_requests" ] }, "description": "Parameters: applicationId: The unique identifier of the application Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/application_access_requests Response Messages: 400: The application was already deleted. 401: Access is denied 401: You do not have permission to access application with ID 401: No available licenses. Ask your SecureApp administrator for assistance. 404: There is no application with the specified ID." }, "response": [] }, { "name": "Create application access request", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "<application_access_request>\n\t<server_group_id>1</server_group_id>\n\t<server_ip>1.1.1.1</server_ip>\n\t<comment>Request to join the WebServers server group</comment>\n</application_access_request>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/application_access_requests", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "application_access_requests" ] }, "description": "Parameters: applicationId: The unique identifier of the application body: application access request Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/application_access_requests</td></tr><tr><td>BODY</td><td><application_access_request>     <server_group_id>1</server_group_id>     <server_ip>1.1.1.1</server_ip>     <comment>Request to join the WebServers server group</comment> </application_access_request></td></tr></table> Response Messages: 201: Application access request was submitted. 400: The application was already deleted. 400: Server id cannot be empty. 400: Hostname or IP cannot be empty. 400: The provided server does not exist in application. 400: The provided server is not allowed to access. 400: Request already created 400: Requester cannot be null 400: Group cannot be empty 400: Invalid ip 401: Access is denied 401: No available licenses. Ask your SecureApp administrator for assistance. 404: There is no application with the specified ID." }, "response": [] }, { "name": "Update application access requests", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "<application_access_requests>\n\t<application_access_request>\n\t\t<id>1</id>\n\t\t<action>APPROVE</action>\n\t</application_access_request>\n\t<application_access_request>\n\t\t<id>2</id>\n\t\t<action>REJECT</action>\n\t</application_access_request>\n</application_access_requests>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/application_access_requests", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "application_access_requests" ] }, "description": "Use this API to approve or reject application access requests Parameters: applicationId: The unique identifier of the application body: application access requests Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/application_access_requests</td></tr><tr><td>BODY</td><td><application_access_requests>     <application_access_request>         <id>1</id>         <action>APPROVE</action>     </application_access_request>     <application_access_request>         <id>2</id>         <action>REJECT</action>     </application_access_request> </application_access_requests></td></tr></table> Response Messages: 200: Application access requests were updated. 400: The application was already deleted. 400: Invalid ID for access request 400: Cannot update access request with id ID 400: Action cannot be empty in request with id ID 400: Invalid action in request with id ID 400: The Server group is lock for discovery 401: Access is denied 401: No available licenses. Ask your SecureApp administrator for assistance. 404: There is no application with the specified ID." }, "response": [] }, { "name": "Retrieve an existing application access request by ID", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/application_access_requests/{{requestId}}", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "application_access_requests", "{{requestId}}" ] }, "description": "Parameters: applicationId: The unique identifier of the application requestId: The unique identifier of the application access request Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/application_access_requests/1 Response Messages: 400: The application was already deleted. 401: Access is denied 401: You do not have permission to access application with ID 401: No available licenses. Ask your SecureApp administrator for assistance. 404: There is no application with the specified ID. 404: Access request with id ID was not found in application with id ID" }, "response": [] }, { "name": "Update an application access request", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "<application_access_request>\n\t<action>APPROVE</action>\n</application_access_request>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/application_access_requests/{{requestId}}", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "application_access_requests", "{{requestId}}" ] }, "description": "Use this API to approve or reject application access requests Parameters: applicationId: The unique identifier of the application requestId: The unique identifier of the application access request body: application access request Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/application_access_requests/1</td></tr><tr><td>BODY</td><td><application_access_request>     <action>APPROVE</action> </application_access_request></td></tr></table> Response Messages: 200: Application access request was updated. 400: The application was already deleted. 400: Invalid ID for access request 400: Cannot update access request with id ID 400: Action cannot be empty in request with id ID 400: Invalid action in request with id ID 400: The Server group is lock for discovery 401: Access is denied 401: No available licenses. Ask your SecureApp administrator for assistance. 404: There is no application with the specified ID." }, "response": [] } ] }, { "name": "Application Connections", "item": [ { "name": "Create connections", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "<connections>\n\t <connection>\n\t\t <name>Connection A</name>\n\t\t <comment>Connection A comment</comment>\n\t\t <sources>\n\t\t\t <source>\n\t\t\t\t <id>2</id>\n\t\t\t </source>\n\t\t\t <source>\n\t\t\t\t <id>3</id>\n\t\t\t </source>\n\t\t </sources>\n\t\t <services>\n\t\t\t <service>\n\t\t\t\t <id>1</id>\n\t\t\t </service>\n\t\t </services>\n\t\t <destinations>\n\t\t\t <destination>\n\t\t\t\t <id>1</id>\n\t\t\t </destination>\n\t\t </destinations>\n\t </connection>\n\t <connection>\n\t\t <name>Connection B</name>\n\t </connection>\n\t <connection>\n\t\t <name>Connection C</name>\n\t\t <sources>\n\t\t\t <source>\n\t\t\t\t <id>2</id>\n\t\t\t </source>\n\t\t </sources>\n\t </connection>\n</connections>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/connections", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "connections" ] }, "description": "Parameters: applicationId: The unique identifier of the application body: The list of the connections Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/2/connections</td></tr><tr><td>BODY</td><td><connections>      <connection>          <name>Connection A</name>          <comment>Connection A comment</comment>          <sources>              <source>                  <id>2</id>              </source>              <source>                  <id>3</id>              </source>          </sources>          <services>              <service>                  <id>1</id>              </service>          </services>          <destinations>              <destination>                  <id>1</id>              </destination>          </destinations>      </connection>      <connection>          <name>Connection B</name>      </connection>      <connection>          <name>Connection C</name>          <sources>              <source>                  <id>2</id>              </source>          </sources>      </connection> </connections></td></tr></table> Response Messages: 200: Connections were created. 201: Connection was created. 400: There are no items to add. 400: You cannot add to application NAME because it was decommissioned. 400: Connection name already exists. 400: Reference to service ID is invalid. 400: Reference to source/destination with ID is invalid. 400: Connection NAME contains duplicate destinations. 400: Destination cannot contain users. 400: Resource cannot contain other objects along with Any. 400: Connection NAME contains duplicate sources. 400: You cannot add external resources to interface connections. 400: You cannot have Any in both the source and destination. 400: You cannot add external resources to interface connections. 400: Source cannot contain both users and servers. 400: Connection NAME contains duplicate services. 400: Cannot contain other services along with ANY. 400: Connections can only include objects within the same customer. 401: You do not have permission to access application that contains the server ID 401: No available licenses. Ask your SecureApp administrator for assistance. 401: You do not have permissions to edit this application. 401: Access is denied 404: There is no application with the specified ID." }, "response": [] }, { "name": "Update connections", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "<connections>\n\t <connection>\n\t\t <id>1</id>\n\t\t <name>Connection A</name>\n\t\t <comment>Connection A comment</comment>\n\t\t <sources>\n\t\t\t <source>\n\t\t\t\t <id>2</id>\n\t\t\t </source>\n\t\t\t <source>\n\t\t\t\t <id>3</id>\n\t\t\t </source>\n\t\t </sources>\n\t\t <services>\n\t\t\t <service>\n\t\t\t\t <id>1</id>\n\t\t\t </service>\n\t\t </services>\n\t\t <destinations>\n\t\t\t <destination>\n\t\t\t\t <id>1</id>\n\t\t\t </destination>\n\t\t </destinations>\n\t </connection>\n\t <connection>\n\t\t <id>2</id>\n\t\t <name>Connection B</name>\n\t </connection>\n\t <connection>\n\t\t <id>3</id>\n\t\t <name>Connection C</name>\n\t\t <sources>\n\t\t\t <source>\n\t\t\t\t <id>2</id>\n\t\t\t </source>\n\t\t </sources>\n\t </connection>\n</connections>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/connections", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "connections" ] }, "description": "Parameters: applicationId: The unique identifier of the application body: List of connections Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/2/connections</td></tr><tr><td>BODY</td><td><connections>      <connection>          <id>1</id>          <name>Connection A</name>          <comment>Connection A comment</comment>          <sources>              <source>                  <id>2</id>              </source>              <source>                  <id>3</id>              </source>          </sources>          <services>              <service>                  <id>1</id>              </service>          </services>          <destinations>              <destination>                  <id>1</id>              </destination>          </destinations>      </connection>      <connection>          <id>2</id>          <name>Connection B</name>      </connection>      <connection>          <id>3</id>          <name>Connection C</name>          <sources>              <source>                  <id>2</id>              </source>          </sources>      </connection> </connections></td></tr></table> Response Messages: 200: Connections were modified. 400: Reference to service ID is invalid. 400: Reference to source/destination with ID is invalid. 400: Connection name cannot be empty. 400: Connection name already exists. 400: Connection NAME contains duplicate destinations. 400: Destination cannot contain users. 400: Resource cannot contain other objects along with Any. 400: Connection NAME contains duplicate sources. 400: You cannot add external resources to interface connections. 400: You cannot have Any in both the source and destination. 400: You cannot add external resources to interface connections. 400: Source cannot contain both users and servers. 400: Connection NAME contains duplicate services. 400: Cannot contain other services along with ANY. 400: Connections can only include objects within the same customer. 401: No available licenses. Ask your SecureApp administrator for assistance. 401: You do not have permission to access application that contains the server ID 401: You do not have permissions to edit this application. 401: Access is denied 401: You cannot edit or delete an external connection. 404: There is no application with the specified ID. 404: Connection with ID was not found for application with ID." }, "response": [] }, { "name": "Retrieve existing connections", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/connections", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "connections" ] }, "description": "Parameters: applicationId: The unique identifier of the application name: The name of the connection [optional] Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections?name=Connection Name Response Messages: 401: No available licenses. Ask your SecureApp administrator for assistance. 401: Access is denied 401: You do not have permission to access application with ID 404: There is no application with the specified ID. 404: There are no connections with the name NAME." }, "response": [] }, { "name": "Retrieve existing connections, with extended resources information", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/connections_extended", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "connections_extended" ] }, "description": "Parameters: applicationId: The unique identifier of the application name: The name of the connection [optional] start: Return results starting only from the specified index; 0-based index; default value = 0 [optional] count: Return the specified number of results. Returns all results if no value specified [optional] Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections_extended Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections_extended?name=Connection Name Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections_extended?name=Connection Name&start=50&count=100 Response Messages: 400: Start value cannot be a negative number. 400: Count value must be greater than 0. 401: No available licenses. Ask your SecureApp administrator for assistance. 401: Access is denied. 404: There is no application with the specified ID. 404: There are no connections with the name NAME." }, "response": [] }, { "name": "Create a ticket to repair a connection", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "<ticket>\n\t<subject>Repair connection 2</subject>\n\t<requester>u1</requester>\n\t<priority>Normal</priority>\n\t<workflow>\n\t\t<name>Workflow with topology</name>\n\t</workflow>\n\t<steps>\n\t\t<step>\n\t\t\t<name>Open request</name>\n\t\t\t<tasks>\n\t\t\t\t<task>\n\t\t\t\t\t<fields>\n\t\t\t\t\t\t<field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"text_area\">\n\t\t\t\t\t\t\t<name>Business Justification</name>\n\t\t\t\t\t\t\t<text>I need access to ftp </text>\n\t\t\t\t\t\t</field>\n\t\t\t\t\t\t<field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"text_field\">\n\t\t\t\t\t\t\t<name>Project Number</name>\n\t\t\t\t\t\t\t<text>CR124560</text>\n\t\t\t\t\t\t</field>\n\t\t\t\t\t\t<field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"hyperlink\">\n\t\t\t\t\t\t\t<name>Hyperlink</name>\n\t\t\t\t\t\t\t<url>http://192.168.1.1/ticket</url>\n\t\t\t\t\t\t</field>\n\t\t\t\t\t\t<field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"drop_down_list\">\n\t\t\t\t\t\t\t<name>Change Window</name>\n\t\t\t\t\t\t\t<selection>Monday</selection>\n\t\t\t\t\t\t</field>\n\t\t\t\t\t\t<field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"manager\">\n\t\t\t\t\t\t\t<name>manager email</name>\n\t\t\t\t\t\t\t<text>manager@tufin.com</text>\n\t\t\t\t\t\t</field>\n\t\t\t\t\t</fields>\n\t\t\t\t</task>\n\t\t\t</tasks>\n\t\t</step>\n\t</steps>\n\t<comments/>\n</ticket>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{application_id}}/connections/{{connection_id}}/repair", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{application_id}}", "connections", "{{connection_id}}", "repair" ] }, "description": "Parameters: application_id: The application ID connection_id: The connection ID body: Ticket Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections/2/repair</td></tr><tr><td>BODY</td><td><ticket>     <subject>Repair connection 2</subject>     <requester>u1</requester>     <priority>Normal</priority>     <workflow>         <name>Workflow with topology</name>     </workflow>     <steps>         <step>             <name>Open request</name>             <tasks>                 <task>                     <fields>                         <field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"text_area\">                             <name>Business Justification</name>                             <text>I need access to ftp </text>                         </field>                         <field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"text_field\">                             <name>Project Number</name>                             <text>CR124560</text>                         </field>                         <field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"hyperlink\">                             <name>Hyperlink</name>                             <url>http://192.168.1.1/ticket</url>                         </field>                         <field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"drop_down_list\">                             <name>Change Window</name>                             <selection>Monday</selection>                         </field>                         <field xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:type=\"manager\">                             <name>manager email</name>                             <text>manager@tufin.com</text>                         </field>                     </fields>                 </task>             </tasks>         </step>     </steps>     <comments/> </ticket></td></tr></table> Response Messages: 201: Ticket was created. 401: Access is denied. 401: To create a ticket you must purchase a valid SecureChange license. 401: No available licenses. Ask your SecureApp administrator for assistance. 401: You do not have permissions to edit this application. 404: There is no application with the specified ID. 404: Connection with ID was not found for application with ID. 403: Cannot create a ticket to repair this connection because the connection status is not disconnected. 403: Cannot create a ticket to repair this connection because the connection was edited but a ticket has not been created yet. 403: Cannot create a ticket to repair this connection because there are other open tickets for an application that includes this connection. 400: The requester must be the currently logged in user. 400: Workflow was not found. 400: Workflow is not active. 400: Workflow configuration is not valid. 400: Workflow is not set. 401: Logged in user: NAME do not have permission to perform on behalf actions. 401: You are not a participant in the first step of this workflow. 400: You cannot enter a status for a new ticket. 400: Requester cannot open a ticket in domain. 400: Invalid ticket priority. 400: Expiration field is required. 400: Submit ticket enabled only with the first step. 400: First step can be only with one task. 400: The specified workflow does not contain an access request field in the first step. 400: You cannot use an access request field to create a ticket from SecureApp. 400: The ticket fields do not match the fields in the current step of the workflow. 400: You cannot change the value of a field because it is read-only." }, "response": [] }, { "name": "Delete connection", "request": { "method": "DELETE", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "applicationId", "value": null, "type": "text" }, { "key": "connectionId", "value": null, "type": "text" } ] }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/connections/{{connectionId}}", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "connections", "{{connectionId}}" ] }, "description": "Parameters: applicationId: The unique identifier of the application connectionId: The unique identifier of the connection Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections/1 Response Messages: 200: Connection was deleted. 401: No available licenses. Ask your SecureApp administrator for assistance. 401: You do not have permissions to edit this application. 401: Access is denied 401: You cannot edit or delete an external connection. 404: There is no application with the specified ID. 404: Connection with ID was not found for application with ID." }, "response": [] }, { "name": "Update a connection", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": " <connection>\n\t <name>Connection A</name>\n\t <comment>Connection A comment</comment>\n\t <sources>\n\t\t <source>\n\t\t\t <id>2</id>\n\t\t </source>\n\t\t <source>\n\t\t\t <id>3</id>\n\t\t </source>\n\t </sources>\n\t <services>\n\t\t <service>\n\t\t\t <id>1</id>\n\t\t </service>\n\t </services>\n\t <destinations>\n\t\t <destination>\n\t\t\t <id>1</id>\n\t\t </destination>\n\t </destinations>\n </connection>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/connections/{{connectionId}}", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "connections", "{{connectionId}}" ] }, "description": "Parameters: applicationId: The unique identifier of the application connectionId: The unique identifier of the connection body: Connection Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/2/connections/1</td></tr><tr><td>BODY</td><td> <connection>      <name>Connection A</name>      <comment>Connection A comment</comment>      <sources>          <source>              <id>2</id>          </source>          <source>              <id>3</id>          </source>      </sources>      <services>          <service>              <id>1</id>          </service>      </services>      <destinations>          <destination>              <id>1</id>          </destination>      </destinations> </connection></td></tr></table> Response Messages: 200: Connection was modified. 400: Reference to service ID is invalid. 400: Reference to source/destination with ID is invalid. 400: Connection name cannot be empty. 400: Connection name already exists. 400: Connection NAME contains duplicate destinations. 400: Destination cannot contain users. 400: Resource cannot contain other objects along with Any. 400: Connection NAME contains duplicate sources. 400: You cannot add external resources to interface connections. 400: You cannot have Any in both the source and destination. 400: You cannot add external resources to interface connections. 400: Source cannot contain both users and servers. 400: Connection NAME contains duplicate services. 400: Cannot contain other services along with ANY. 400: Connections can only include objects within the same customer. 401: No available licenses. Ask your SecureApp administrator for assistance. 401: You do not have permission to access application that contains the server ID 401: You do not have permissions to edit this application. 401: Access is denied 401: You cannot edit or delete an external connection. 404: There is no application with the specified ID. 404: Connection with ID was not found for application with ID." }, "response": [] }, { "name": "Retrieve an existing connection by ID", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/connections/{{connectionId}}", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "connections", "{{connectionId}}" ] }, "description": "Parameters: applicationId: The unique identifier of the application connectionId: The unique identifier of the connection Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/connections/1 Response Messages: 401: No available licenses. Ask your SecureApp administrator for assistance. 401: Access is denied 401: You do not have permission to access application with ID 404: There is no application with the specified ID. 404: Connection with ID was not found for application with ID." }, "response": [] } ] }, { "name": "Application Identities", "item": [ { "name": "Fetches application identities", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/application_identities", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "application_identities" ] }, "description": "Fetches the list of pre-defined application identities (like facebook) that can be used in a connection. Parameters: name: The name of the service [optional] Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/application_identities Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/application_identities?name=facebook Response Messages: 404: There are no application identities with the name NAME. 401: Access is denied." }, "response": [] } ] }, { "name": "Application Interfaces", "item": [ { "name": "Delete interface connection", "request": { "method": "DELETE", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "applicationId", "value": null, "type": "text" }, { "key": "applicationInterfaceId", "value": null, "type": "text" }, { "key": "connectionInterfaceId", "value": null, "type": "text" } ] }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/application_interfaces/{{applicationInterfaceId}}/interface_connections/{{connectionInterfaceId}}", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "application_interfaces", "{{applicationInterfaceId}}", "interface_connections", "{{connectionInterfaceId}}" ] }, "description": "Parameters: applicationId: The unique identifier of the application applicationInterfaceId: The unique identifier of the application interface connectionInterfaceId: The unique identifier of the interface connection Usage Example https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/application_interfaces/1/interface_connections/1 Response Messages: 200: Interface connection was deleted. 401: Access is denied 401: No available licenses. Ask your SecureApp administrator for assistance. 401: You do not have permissions to edit this application. 404: There is no application with the specified ID. 404: Application interface with ID was not found for application with ID. 404: Connection interface with ID was not found for application interface with ID." }, "response": [] }, { "name": "Update an interface connection", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/xml" } ], "body": { "mode": "raw", "raw": "<interface_connection>\n\t<name>Updated name</name>\n\t<sources>\n\t\t<source>\n\t\t\t<id>19</id>\n\t\t</source>\n\t</sources>\n\t<services>\n\t\t<service>\n\t\t\t<id>9</id>\n\t\t</service>\n\t</services>\n\t<comment>Updated connection</comment>\n</interface_connection>" }, "url": { "raw": "https://{{SecureApp_IP}}/securechangeworkflow/api/secureapp/repository/applications/{{applicationId}}/application_interfaces/{{applicationInterfaceId}}/interface_connections/{{connectionInterfaceId}}", "protocol": "https", "host": [ "{{SecureApp_IP}}" ], "path": [ "securechangeworkflow", "api", "secureapp", "repository", "applications", "{{applicationId}}", "application_interfaces", "{{applicationInterfaceId}}", "interface_connections", "{{connectionInterfaceId}}" ] }, "description": "Parameters: applicationId: The unique identifier of the application applicationInterfaceId: The unique identifier of the application interface connectionInterfaceId: The unique identifier of the interface connection body: The interface connection Usage Example <table><tr><td>URL</td><td>https://192.168.1.1/securechangeworkflow/api/secureapp/repository/applications/1/application_interfaces/1/interface_connections/1</td></tr><tr><td>BODY</td><td><interface_connection>     <name>Updated name</name>     <sources>         <source>             <id>19</id>         </source>     </sources>     <services>         <service>             <id>9</id>         </service>     </services>     <comment>Updated connection</comment> </interface_connection></td></tr></table> Response Messages: 200: Interface connection was modified. 400: Interface connection name cannot be empty. 400: Connection name already exists. 400: You cannot add user to connection interface. 400: You cannot add Any to connection interface. 400: You cannot add Internet to connection interface. 400: Cannot have external servers. 400: Cannot have both sources and destinations. 400: Connection NAME contains duplicate sources. 400: Connection NAME contains duplicate services. 400: