Extend getting started docs with information about setting SharePoint URL
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 1.5k
- Forks
- 413
- Avg merge
- 5d 6h
- Merged PRs (30d)
- 21
Description
When using CLI for M365 with custom AAD apps, you get to choose which permissions you want to grant. Unfortunately, spo commands depend on SharePoint URL discovery and require the Microsoft Graph Sites.Read.All scope. Without this scope, using the command fails with a vague error: AccessDenied: Either scp or roles claim need to be present in the token. This can be solved either by adding this scope to the AAD app, or manually setting the SharePoint root url using m365 spo set --url https://yourtenant.sharepoint.com after logging in but before calling spo commands. We should add this information to our Getting started docs.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start in the repository's Getting started documentation and locate the section covering custom AAD apps and SharePoint commands. Document the required Microsoft Graph Sites.Read.All scope and the alternative m365 spo set --url step; the work is done when users can understand both ways to configure the SharePoint URL before using spo commands.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cli
- Domain
- cli, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 50/100