Connectors Reference

Rencore Governance

Rencore Governance helps you to automate managing your Office 365 tenant.

 

Status: Preview

Tier: Premium

Version: 1.0

 

Actions:

Name

Summary

GetWorkspaces ()

Get workspaces

GetEnvironments (string workspaceId)

Get connected environments

GetChecks (string workspaceId, string environmentId)

Get available checks

DeleteHook (string workspaceId, string environmentId, string checkId, string hookId)

Delete hook

GetViolations (string workspaceId, string environmentId, string checkId)

Get check violations

 

Triggers:

Name

Summary

CheckNotificationTrigger (string workspaceId, string environmentId, string checkId, CheckNotificationTriggerParameterBody body)

When a check in Rencore Governance is violated

 

Objects:

Name

Summary

CheckNotificationTriggerParameterBody

 

GetChecksResponseItem

 

GetEnvironmentsResponseItem

 

GetViolationsResponse

 

GetWorkspacesResponseItem

 

violationResource

 

violationResourcePrincipal

 

violationResourcePrincipalWithoutResources

 

violationResourceWithoutPrincipals

 

 

Actions:

GetWorkspaces

Summary: Get workspaces

Description: Get workspaces

 

Syntax:

RencoreGovernance.GetWorkspaces ()

 

Returns:

          Type:array of (GetWorkspacesResponseItem)

 

GetEnvironments

Summary: Get connected environments

Description: Get connected environments

 

Syntax:

RencoreGovernance.GetEnvironments (string workspaceId)

 

Parameters:

Name

Type

Summary

Required

Related Action

workspaceId

string

(Workspace)

Workspace for which you want to receive notifications

True

GetWorkspaces

 

Returns:

          Type:array of (GetEnvironmentsResponseItem)

 

GetChecks

Summary: Get available checks

Description: Get available checks

 

Syntax:

RencoreGovernance.GetChecks (string workspaceId, string environmentId)

 

Parameters:

Name

Type

Summary

Required

Related Action

workspaceId

string

(Workspace)

Workspace for which you want to receive notifications

True

GetWorkspaces

environmentId

string

(Environment)

Environment for which you want to receive notifications

True

GetEnvironments

 

Returns:

          Type:array of (GetChecksResponseItem)

 

DeleteHook

Summary: Delete hook

Description: Delete hook

 

Syntax:

RencoreGovernance.DeleteHook (string workspaceId, string environmentId, string checkId, string hookId)

 

Parameters:

Name

Type

Summary

Required

Related Action

workspaceId

string

 

 

True

environmentId

string

 

 

True

checkId

string

 

 

True

hookId

string

 

 

True

 

Returns:

 

GetViolations

Summary: Get check violations

Description: Get check violations

 

Syntax:

RencoreGovernance.GetViolations (string workspaceId, string environmentId, string checkId)

 

Parameters:

Name

Type

Summary

Required

Related Action

workspaceId

string

(Workspace)

Workspace for which you want to receive notifications

True

GetWorkspaces

environmentId

string

(Environment)

Environment for which you want to receive notifications

True

GetEnvironments

checkId

string

(Check)

Check for which you want to receive notifications

True

GetChecks

 

Returns:

          Type:GetViolationsResponse

 

Triggers:

Trigger CheckNotificationTrigger

Summary: When a check in Rencore Governance is violated

Description: Get notified of changes in your environment monitored by Rencore Governance

 

Syntax:

RencoreGovernance.CheckNotificationTrigger (string workspaceId, string environmentId, string checkId, CheckNotificationTriggerParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

workspaceId

string

(Workspace)

Workspace for which you want to receive notifications

True

GetWorkspaces

environmentId

string

(Environment)

Environment for which you want to receive notifications

True

GetEnvironments

checkId

string

(Check)

Check for which you want to receive notifications

True

GetChecks

body

CheckNotificationTriggerParameterBody

 

 

True

 

Returns:

 


 

CheckNotificationTriggerParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

url

string

 

url


 

GetChecksResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

 

id

name

string

 

name


 

GetEnvironmentsResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

 

id

name

string

 

name


 

GetViolationsResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

checkInfo

CheckInfo

 

Information about the violated check

affectedUsers

array of (violationResourcePrincipal)

 

Users affected by the non-compliant resources they either own or use

nonCompliantResources

array of (violationResource)

 

List of resources that violate the check

totalAffectedUsers

integer

 

The total number of users affected by the non-compliant resources they either own or use

totalNonCompliantResources

integer

 

The total number of resources that violate the check

totalResources

integer

 

The total number of resources analyzed by the check

 

CheckInfo

Summary:

Description: Information about the violated check

 

          Properties:

Name

Type

Summary

id

string

 

ID of the violated check

name

string

 

Name of the violated check

description

string

 

Description of the violated check

category

string

 

Category of the violated check

targetService

string

 

Microsoft 365 service in which the check was violated

severity

string

 

Severity of the violated check

totalCount

TotalCount

 

 

 

TotalCount

Summary:

Description:

 

          Properties:

Name

Type

Summary

 


 

GetWorkspacesResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

 

id

name

string

 

name


 

violationResource

Summary:

Description:

 

          Properties:

Name

Type

Summary

enabled

boolean

 

True if the resource is enabled and false if it's disabled

id

string

 

Unique ID of the resource

lastUsed

string

 

Date and time when the resource was last used

name

string

 

Name of the resource

nonCompliantSince

string

 

Date and time when the analysis discovered the resource as being non-compliant with the check

owners

array of (violationResourcePrincipalWithoutResources)

 

List of principals who own this resource

type

string

 

Type of the resource

url

string

 

URL to access the resource in the browser

users

array of (violationResourcePrincipalWithoutResources)

 

List of principals who use this resource


 

violationResourcePrincipal

Summary:

Description:

 

          Properties:

Name

Type

Summary

email

string

 

Person's e-mail address

name

string

 

User's or group's display name

ownedNonCompliantResources

array of (violationResourceWithoutPrincipals)

 

Non-compliant resources owned by this principal

type

string

 

Type of principal

usedNonCompliantResources

array of (violationResourceWithoutPrincipals)

 

Non-compliant resources used by this principal


 

violationResourcePrincipalWithoutResources

Summary:

Description:

 

          Properties:

Name

Type

Summary

email

string

 

Person's e-mail address

name

string

 

User's or group's display name

type

string

 

Type of principal


 

violationResourceWithoutPrincipals

Summary:

Description:

 

          Properties:

Name

Type

Summary

enabled

boolean

 

True if the resource is enabled and false if it's disabled

id

string

 

Unique ID of the resource

lastUsed

string

 

Date and time when the resource was last used

name

string

 

Name of the resource

nonCompliantSince

string

 

Date and time when the analysis discovered the resource as being non-compliant with the check

type

string

 

Type of the resource

url

string

 

URL to access the resource in the browser