Skip to content

GitLab Next

    • GitLab: the DevOps platform
    • Explore GitLab
    • Install GitLab
    • How GitLab compares
    • Get started
    • GitLab docs
    • GitLab Learn
  • Pricing
  • Talk to an expert
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
    • Menu
    Projects Groups Snippets
  • Sign up now
  • Login
  • Sign in / Register
  • Support Team Meta Support Team Meta
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 193
    • Issues 193
    • List
    • Boards
    • Service Desk
    • Milestones
    • Iterations
  • Merge requests 4
    • Merge requests 4
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
    • Test Cases
  • Deployments
    • Deployments
    • Releases
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Code review
    • Insights
    • Issue
    • Repository
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar

GitLab 15.0 has launched! Please visit Breaking changes in 15.0 and 15.0 Removals to see which breaking changes may impact your workflow.

  • GitLab.com
  • GitLab Support Team
  • Support Team MetaSupport Team Meta
  • Issues
  • #2885
Closed
Open
Created Nov 06, 2020 by Cynthia "Arty" Ng@cynthia🌴Maintainer20 of 26 tasks completed20/26 tasks

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:
    • SAML training
    • SCIM docs

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

  • https://docs.google.com/presentation/d/1ZceIBJFuWzWMtRMsCSVnoKOHbVFo4TWHegKdNVacD8g/edit

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)

Issues

  • Expose SCIM identity in Admin GUI
Edited Dec 21, 2020 by Cynthia "Arty" Ng
Assignee
Assign to
Time tracking