Skip to content
GitLab
Next
Closed
Issue created by Cynthia "Arty" Ng@cynthia🌴Maintainer

Deep Dive on SCIM

Deep Dive on SCIM

  • 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:

  1. Overview of how SCIM is used and how it's related to SAML for GitLab.com.
  2. Typical troubleshooting steps including what user can do versus support.

Objectives

After the deep dive each participant will be able to:

  1. Explain the purpose of SCIM in GitLab.
  2. Explain the basics of how SCIM works for SSO.
  3. 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
  • Host: Share a link to the recording with:
  • 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

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

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:

Merge Requests:

Issues

Edited by Cynthia "Arty" Ng