GuidesAPI Reference
API Reference

Create or update a cross realm trust

post
https://Use API Lookup for a base URL/crossRealmTrusts/sources//targets/

Create or update a CrossRealmTrust that allows LinkableResources to be received from the source of the resource. The source HRN is defined by either the home project or the realm of the resource. The CrossRealmTrust is established with a target specified in the path which could either be a specific project or the entire realm. An access token from an identity with appropriate privileges in the target realm should be used to create/update the CrossRealmTrust.


Access Control:

  • The calling principal must have "manageCrossRealmTrust" action permission for the resource "{realm}" in the "authorization" service. The "{realm}" here represents the HRN of represent the target realm.
  • This permission is granted to all entities with roles OrgAdmin or CrossRealmTrustManager.
  • The calling principal MUST NOT include a project scope.
Path Params
string
required

HRN identifying the source realm or project

string
required

HRN identifying the target realm or project

Body Params
boolean

Indicate whether or not an actor in the source Realm must always specify a project in the target Realm when offering a LinkableResource. When this is set to true, the User or App in the source realm cannot offer the LinkableResource broadly in the target Realm such that it could be added to any Project in the target Realm. Defaults to false, which allows the User or App in the source Realm to create LinkableResources identifying the target Realm, such that the ResourceLink can be added to any Project in the target Realm.

Headers
string

Correlates HTTP requests between a client and server. If not present in the incoming request, it will be generated.

Responses

Updated 2 months ago

Language
Credentials
Bearer
JWT
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 2 months ago