Team Structure Connector FAQ
In this article:
Integration security
How can you help with a security review?
- File encryption: Pluralsight supports PGP encryption for secure file transfers. We provide a PGP public key for encrypting files, and we securely store the private key for decryption.
- Authentication: We use Basic Auth, but it operates like Bearer Auth. The API Key you use is a Bearer Token, which is securely encrypted. The Username in Basic Auth is ignored.
What security measures are in place?
- Data in Transit: We use HTTP/SSL to secure data transfers.
- Optional Encryption: PGP Encryption can be enabled. Contact your CSM and the PaaS Team for details.
Sync customization
How do I ensure certain employees, like contract workers, are not given Pluralsight access?
The connector syncs only users with existing licenses in Pluralsight. Contract workers without licenses will be ignored. You can also filter them out in your reports.
Licenses and permissions
Will users added as managers receive an email?
Yes, managers will receive an email inviting them to view their teams' analytics.
What team structures/analytics will managers and plan admins see?
- Managers: Learn more about permissions here.
- Plan admins: Learn more about their view here.
Future enhancements
How can I test future enhancements?
You will be able to use the “dry run” feature to test new versions before updating the connector. For breaking changes, the connector version will be updated. Check the Versioning Integrations page for more information.
Technical details
Is there a limit to the number of values in rootTeamId?
There is no current limit. However, using higher-level team IDs that include child teams is recommended for efficiency.
Should URL parameters be sent via both files?
Yes, parameters like dryRun, sendManagerInvites, and rootTeamIds should be included in the URLs for both files.
If users are on manually created teams and different teams in the import, will they be on both teams?
Yes, if you use the rootTeamIds parameter. Without it, manually created teams will be removed or adjusted based on the import.
Can I turn off email invites to managers during testing?
Yes, refer to the Turning Off Manager Invites section of the Setup page for instructions.
Why are there unassigned users?
- Missing from files: User not included in the provided files.
- Matching issues: No match found based on ID or email criteria.
- ID from users report ↔ SSO ID in Pluralsight
- Email from users report ↔ primary email in Pluralsight
- Email from users report ↔ additional emails in Pluralsight
- Common reasons:
- Incorrect SSO/email
- Verify that SSO and email addresses are correct in both systems.
- Issues with rootTeamId
- Only users under specified rootTeamIds will be synced.
- Terminated users.
- Users who are no longer with the company will not appear in the Users Report but will still exist in Pluralsight. Admins need to manually remove these users.