Set up Connect
Get started
If Posit Connect is not already configured from the landing page and running, select the Connect logo.
Connect setup requires application roles POSIT_TEAM_ADMIN or POSIT_CONNECT_ADMIN. See top right corner to see your permissions. If you originally installed the Posit Team Native App, you already have all roles.
Configuration
License
Connect requires an Advanced license file. If you have a license file, upload it via the file input to validate it. If you do not have a license file, please contact Posit sales.
Alternatively, Posit Team supports a free 30-day trial of Connect that you can start by clicking the Get a free trial license button. A modal will appear asking you to agree to the Posit End User License Agreement (EULA). Contact snowflakemarketplace@posit.co to purchase a license before the 30-day trial expires to continue normal operation of Connect.
Compute pool
The compute pool size you choose is dependent on how you plan to use your instance of Connect.
For a small team (3-5 users) that produces a few pieces of content each day, use at least a small (CPU_X64_S) compute cluster. To better understand your team’s needs, we recommend starting with a size slightly larger than you may need (which avoids out-of-memory errors), monitoring the resource usage, and then adjusting your compute cluster size accordingly.
Once you click Continue, Connect begins to provision. It takes roughly 10 minutes to create the compute pool and start the Connect container. You can resize the compute pool after initial configuration, which takes about 15 minutes.
Using backups from another Posit Team Native App
You can launch Connect within the Posit Team Native App using a previously created backup. Posit Team can use backups from other installations as well as backups created by the same installation.
The target Posit Team Native App needs to be granted the POSIT_TEAM_ADMIN application role in order to enumerate and access the backups associated with your source Posit Team Native App.
Assuming that your source Posit Team Native App is named POSIT_TEAM_SOURCE and your target Posit Team Native App is named POSIT_TEAM_TARGET, run the following Snowflake SQL to grant access:
Snowsight UI
GRANT APPLICATION ROLE POSIT_TEAM_SOURCE.POSIT_TEAM_ADMIN TO APPLICATION POSIT_TEAM_TARGET;After running this code, you can ask that backups from POSIT_TEAM_SOURCE be used when launching Connect in the Posit Team Native App named POSIT_TEAM_TARGET.
OAuth integrations
Administrators
Configure a Snowflake OAuth security integration for Connect so users can access Snowflake resources without configuring credentials or passwords. See the OAuth integration guides to configure other integrations.
If you have Private Link or an active network policy, you will need to complete additional steps documented in AWS PrivateLink docs, Azure PrivateLink docs, or Network Policy docs for the Connect Snowflake integration to work. These steps do not need to be completed before the setup steps below, but the Snowflake integration feature will not work until they are completed.
To create and activate the Snowflake OAuth integration copy the SQL code generated on the OAuth setup step and run it in a Snowflake Worksheet as an ACCOUNTADMIN.
Next, click Continue. This will restart Connect with these credentials and it will be available in 3-4 minutes. Or click Skip to skip the integration and continue with setup.
Once Connect is fully configured and ready, Posit Team redirects you to the product management page. Log in to the Connect app and create a Snowflake integration in the System > Integrations tab.
Use the client_id, client_secret, and account_url returned by the query to configure a Snowflake OAuth integration in Posit Connect.
Publishers
See the Connect documentation to learn how to associate these integrations with your content once it is published.
Caveats
Posit Team does not support AWS Service Account OAuth integrations in Connect. AWS requires a public OpenID Connect (OIDC) configuration endpoint to validate the workload identity tokens that Connect creates for assuming Identity and Access Management (IAM) roles. Snowflake must authenticate all traffic to reach any endpoint that a service on Snowpark Container Services (SPCS) exposes. You can still use the AWS Viewer authentication type integration since that validation happens external to Connect.
Ready
Once Connect is fully configured and ready, Posit Team redirects you to the product management page.
Click on the Product URL to be taken to Connect.
Users will typically access Connect from the landing page.
FAQ
Are Connect product updates automatic?
Yes. When the Posit Team Native App is updated, Posit Team automatically upgrades Connect.