Pre Work
Collect the admin roles and keys that Risotto needs for Slack or Microsoft Teams and each tool you plan to connect, before your setup session
Before you set up Risotto, get access to your organization and collect the admin access that each integration needs. With everything ready, you can connect your tools in one session.
Get access
Book a demo to get access to Risotto.
Collect admin access
Chat is the only integration you must connect before you start. Prepare the others for each system your organization uses, in the order below, which is the order the Integrations Overview recommends.
In Risotto, you connect integrations from Settings > Integrations, which only an Admin or a Manager can open.
1. Chat (required)
Prepare one of these:
- Slack: a Slack workspace admin or owner. On Enterprise Grid, a Slack org owner or org admin. Decide whether to install the Marketplace app, or a custom app with your own bot name and icon. See Initial Slack app setup and Custom Slack app setup.
- Microsoft Teams: a Microsoft admin account that can consent to the app's permissions, and admin access to the Microsoft Teams admin center to deploy the app. See Microsoft Teams app setup.
2. Knowledge bases
Prepare access for each documentation source you want Risotto to index:
- Confluence: the Atlassian
Organization adminrole, to install the Confluence app, and an Atlassian API token. See Confluence. - Notion: the Notion Workspace Owner role. See Notion.
- Google Drive: a Google Cloud project where you can turn on the Google Drive API and create a service account. You do not need the Google Admin console. See Google Drive.
- SharePoint: permission to register an application in Microsoft Entra ID and grant it admin consent. See SharePoint.
- Other sources: see Knowledge Bases in the Integrations Overview.
3. Identity provider
- Okta: an Okta super admin, to create an API Services app and assign it the Read-only Administrator, Group Membership Administrator, and Help Desk Administrator roles. See Okta for the scopes.
- Microsoft Entra ID: Global Administrator access, to register an application and grant it admin consent. See Microsoft Entra ID.
- Google Workspace: a Google Workspace admin account. If Google does not grant the admin scopes, connect with a super admin account. See Google Workspace.
- JumpCloud: a JumpCloud admin account with the Administrator role or higher and API access turned on, for its API key. See JumpCloud.
4. Device management, HRIS, and access governance
Prepare these for each system your organization uses.
Device management
- Jamf Pro: Jamf Pro admin privileges to create API roles and clients. See Jamf Pro.
- Iru (formerly Kandji): Iru admin privileges to create API tokens. See Iru.
- Microsoft Intune: Global Administrator access, to register an application and grant it admin consent. See Microsoft Intune.
- Workspace ONE (experimental): admin access to the Workspace ONE UEM console, to create an OAuth client. See Workspace ONE.
HRIS
- Workday: permission to create an Integration System User (ISU), register an x509 public key, and register an API client in Workday. See Workday.
- HiBob: a HiBob admin, to approve the install. See HiBob.
- BambooHR: a BambooHR admin, to approve the install. See BambooHR.
- Rippling: a Rippling admin, and account provisioning for Risotto set up in Rippling. See Rippling.
Access governance
Prepare this only if your organization uses an access governance platform:
- Opal: Opal admin access, to create an API key and an Events Streaming destination. See Opal.
- Okta Identity Governance: Okta Identity Governance turned on in your Okta organization, and the Okta integration connected first. The Okta app also needs the Access Requests Administrator and Super Administrator roles. See Okta Identity Governance.
5. External ticketing (optional)
Risotto has its own tickets. Prepare this only if your team works in an external ticketing platform:
- Jira: the Atlassian
Organization adminrole. See Jira for the permission scopes. - Other platforms: see the Ticketing Integrations Overview.
Create your organization
Go to accounts.tryrisotto.com/sign-up to create your organization.
Something wrong or missing? Report an issue · View as Markdown