RStudio Connect 1.6.8 - Emails, APIs, and Titles
RStudio Connect 1.6.8 includes additions to custom emails, new user endpoints in the RStudio Connect Server API, support for content descriptions and title changes, and important security and authentication improvements.
<image src=”/blog-images/rsc-168-email.png”, height=400px>
Updates
- R Markdown Reports have access to environment variables containing metadata about the report on RStudio Connect. This addition is especially important for custom emails. In case you missed it, recent versions of RStudio Connect allow data scientists to distribute beautiful emails that can include plots, tables, and dynamically generated text. The new metadata can be used to craft an email that includes a link back to the original report or dashboard.
<image src=”/blog-images/rsc-168-footer.png”, width=350px>
- Users in the Connect Server API RStudio Connect v1.6.6 introduced the ability to list user information with the Connect Server API. Version 1.6.8 extends the Server API to include endpoints for creating users and updating users. These endpoints can be used with PAM, proxy, or built-in authentication providers. Future releases will include API support for LDAP/AD and OAuth authentication. As an example, if you are using proxy authentication, you can now programmatically create a user and give them access to content before they log in. The API request can specify all of a user’s attributes or only some. Users will be asked to complete their profile on first login. See the new admin documentation on user provisioning for more information.
curl -v -X POST https://connect.example.com/__api__/v1/users
-H "Content-Type: application/json"
-H "Authentication: Key ***API_KEY***"
-d '{
"username": "john_doe",
"first_name": "John",
"last_name": "Doe",
"email": "jdoe@example.com"
}'
- Content Titles and Descriptions The “Info” settings panel allows publishers and collaborators to edit the content title or - new this release - add a content description. The title and description are visible to viewers with access to the content and administrators. Future RStudio Connect releases will add support for content images, and incorporate all of this information into the content listing page - stay tuned!
<image src=”/blog-images/rsc-168-info.png”, width=350px>
Note: At this time, changing the content title in RStudio Connect does not update the title in the RStudio IDE publish dialog.
Security & Authentication Changes
-
TLS Versions RStudio Connect now supports the
HTTPS.MinimumTLSconfiguration setting which can be used to change the TLS version in use. Specific TLS ciphers can be prohibited using theHTTPS.ProhibitedCiphersconfiguration setting. Before you consider making your server more restrictive, ensure that all supported clients (both browsers and R) support the more restrictive settings. -
LDAP / Active Directory Groups For LDAP or AD installations, administrators should add the
LDAP.GroupUniqueIdAttributeto identify which directory attribute uniquely identifies a group. Existing installations will continue working, but an upcoming release will require this setting on start-up. -
The CLI
usermanagerutility has improved support for group management and offers better support for installations using LDAP/AD.
Deprecations & Breaking Changes
-
Breaking Change The configuration value
Server.SenderEmailis validated at start-up and invalid email addresses will prevent RStudio Connect from starting. -
Breaking Change
Applications.EnvironmentBlacklist, deprecated in 1.6.6, has been removed in favor ofApplications.ProhibitedEnvironment. -
Breaking Change
LDAP.WhitelistedLoginGroups, deprecated in v1.6.6, has been removed in favor ofLDAP.PermittedLoginGroups. -
The
xhr-streamingSockJS protocol has been disabled for Microsoft Edge to fix a bug where Shiny applications became unresponsive. Shiny applications will fall back to a different protocol automatically and will work without any changes.
Please review the full release notes
Upgrade Planning
If you use LDAP or Active Directory, please take note of the LDAP changes described above and in the release notes. Aside from the deprecations and breaking changes above, there are no other special considerations and upgrading should only take few seconds. If you are upgrading from an earlier version, be sure to consult the release notes for the intermediate releases, as well.
If you haven’t yet had a chance to download and try RStudio Connect, we encourage you to do so. RStudio Connect is the best way to share all the work that you do in R (Shiny apps, R Markdown documents, plots, dashboards, Plumber APIs, etc.) with collaborators, colleagues, or customers.
You can find more details or download a 45-day evaluation of the product at https://www.rstudio.com/products/connect/. Additional resources can be found below.
