Deep Dive on SCIM
SCIM
Deep Dive on - Date: 2020-12-07 1:30pm PST (2020-12-08 for APAC)
- Follow-up/Q&A: Please watch at least the "presentation" part of the recording ahead of time.
- Date: 2020-12-07 8am PST inviting EMEA and AMER-E that may not be able to make it.
- Date: 2020-12-06 4pm PST inviting APAC that can't make it.
- Host(s): @cynthia
- Participant Cap:
20
- Participants:
Alvin
Aakif
KateG
Anton
Kaitlyn C.
Sokunrotanak Srey
Jerome Uy
Duncan Harris
Ryan Kelly
Tristan Williams
John Long
Mike Lockhart
Lewis Brown
Nilanka De Silva
Mario Mora
Caleb Williamson
- Assistant:
Duncan Harris
- Complements the following training:
Description
Cover:
- Overview of how SCIM is used and how it's related to SAML for GitLab.com.
- Typical troubleshooting steps including what user can do versus support.
Objectives
After the deep dive each participant will be able to:
- Explain the purpose of SCIM in GitLab.
- Explain the basics of how SCIM works for SSO.
- Troubleshoot SCIM related tickets.
Please also see the documented goals of a Support Deep Dive.
Tasks
Host
Before the call
-
Host: Please read about your role and responsibilities as a host. -
Host: Find, at minimum, 3 participants. You can find them by either asking the Support team to see who's interested or even looking for who's taking a related training module. -
Host: Of the participants, find one to be the assistant. If you haven't already done so, assign them to this issue alongside yourself. -
Host: Think about what prerequisites participants will have to complete so to best be ready for a Deep Dive (i.e. read through specific documentation, set up and use this feature with GitLab, finish the first 2 stages of a training module, running through a few planned scenarios, etc.). Add these to the Before the call section for participants. -
Host: Announce this deep dive to the Support team using in the #support-team-chat
Slack channel and the Support Week in Review. -
Host: Create a public Slack channel and, as per our Internal Communication docs, name it g_spt-TOPIC
. Invite all participants and use this channel to communicate with them and so they can help each other prepare. Link to this issue in the channel's topic. -
Host: Create a Google Doc and ask participants to add to it any questions they have or anything else they'd like to discuss on the call. You may also find this doc helpful when planning how to structure the call. If any questions were added you don't know the answer to, do your best to find the answer. If you're using any Slides or any other docs for the call, link them in this doc too. Add the following disclaimer to the top of the doc: This is a working doc for real time collaboration.
We're targeting to deprecate it and have the content moved to our product documentation after the Deep Dive
-
Host: Create a plan for what to discuss, troubleshoot, or just talk about during the Deep Dive. Stay aware of the objectives you've listed above. Be sure to set aside some time to answer the questions from the Google doc. If there are any slides or additional notes you'll be using, share them here and in the Google doc. -
Host: Once the participants have finished their preparations, schedule the call at a time that works best for all involved. Invite all the participants and GitLab Support
; include links to the Google doc, the issue you created, the slides (if any exist), and the Slack channel in the description. Make sure the call gets recorded.
During the call
-
Host: Confirm that the call is being recorded. -
Host: Mention the latest version of GitLab so the recording will have that context.
After the call
- Host: Recording
-
Upload to YouTube (set to private if necessary) mentioning "Support" in the title -
Add it to the Deep Dive playlist -
Optionally, upload to Support GDrive Training/Deep Dive folder
-
- Host: Share a link to the recording with:
-
The Support team in the Support Week in Review -
The Engineering team in the Engineering Week in Review -
Add it to this issue, under Recording
-
-
Host: Help Participants with any questions they have or help they need with the issues and/or merge requests they have to create. -
Host: After the last issue/merge request is completed, close this issue, close the issue created for the after-call tasks, and archive the Slack channel.
Participants
Before the call
- Please read about the role and responsibilities of a participant.
- Join the Slack channel #g_spt-scim if you're not there already
- Complete the following tasks to understand the basics about the subject:
- Read over the SAML for Groups doc. You don't need to know it in detail, but you should have a general understanding.
- Briefly look over the SCIM for Groups doc so that you have an idea of what's covered.
- Add questions before and during call: https://docs.google.com/document/d/1eZni4Dkz94pD5u8epoN5-dwospVxC4Fb_TJ8zkqi8u0/edit#
As you go through the above tasks, discuss your experience with the others in the Slack channel. Please ask for help where you feel you need it and provide it where you can. Feel free to pair on these tasks too. Add any questions you have or any unclear documentation you find to this deep dive's Google doc.
After the call
- You will be assigned to an issue to help create artifacts. Please pick one or more tasks to complete and do so. Pairing is encouraged. Ask the host, other participants, or even others at GitLab for any help you need.
Assistant
Before the call
-
Assistant: Please read about your role and responsibilities as an assistant. - Complete your tasks as a Participant.
During the call
-
Assistant: Take detailed notes during the call. Include any lessons, questions, answers, troubleshooting steps, suggestions for improvements, etc.
After the call
-
Assistant: Using the notes from the Deep Dive call, create a list of tasks to make any external improvements. Aim to move everything from the Google docs to a permanent location. -
Assistant: Create a new issue to create the artifacts of this call using the Deep Dive (post-call) template. Fill it out completely. Read up on deep dive artifacts to get an idea of the kind of what kind of tasks to create. Consult with the host if you'd like some help. Issue link: issue-link
-
Assistant: In this Deep Dive's Slack channel, inform everyone of the above issue and that they should pick tasks to work on. -
Assistant: After all tasks are completed, confirm that all relevant content from the Google doc made it's way into the docs. If it did, then deprecate it. -
Assistant: Add any issues or merge requests that are created to the Results section, below.
Results
In addition to team-level enablement, deep dives should result in external facing improvements. Please document the outcomes of the deep-dive.
Slides:
Recording:
- https://youtu.be/4OxDhtR_WYM
- APAC follow up: https://youtu.be/SUegvRltdCA
- EMEA follow up: https://youtu.be/VS8oRwfNfrQ
Merge Requests:
- Added to SAML SSO training: support-training!546 (merged)
- Rename SCIM API headers to avoid confusion: gitlab-org/gitlab!49801 (merged)