Error enabling GraphQL IDE with XM Cloud

December 29, 2023 Rodrigo Peplau 0

Recently, I was exploring the GraphQL IDE with XM Cloud. It comes disabled by default, and for security reasons, it’s recommended to keep it disabled in Production environments.

Enabling it is fairly straightforward, as can be seen in this walkthrough. Or so I thought! Yet, as I attempted to navigate the steps, I encountered errors that left me feeling like struggling with supposedly “easy-open” packages.

Reaching the section “Obtain an access token“, more specifically on step 3 when the “curl” command is run, you might see one of the following errors.

With Windows Command Prompt:

curl: (3) URL rejected: Port number was not a decimal number between 0 and 65535

With PowerShell 5.1:

Invoke-WebRequest : A positional parameter cannot be found that accepts argument ‘–request’.
At line:1 char:1
+ curl –location –request POST ‘https://auth.sitecorecloud.io/oauth/t …
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidArgument: (:) [Invoke-WebRequest], ParameterBindingException
+ FullyQualifiedErrorId : PositionalParameterNotFound,Microsoft.PowerShell.Commands.InvokeWebRequestCommand

 

Are easy-open packages really easy to open?

My feelings were correct, and the root cause made me feel stupid: The command only worked well when I ran it in PowerShell 7! It’s not clear if this is a requirement for this walkthrough only. I’ve contacted Sitecore and asked for clarifications, as soon as I get a response I’ll update this article.

To make things a little more confusing, a different walkthrough written by my friend and band partner Sebastian Winter, shows that one of the pre-requisites for using the XM Cloud foundation template is PowerShell 5.1, saying that “PowerShell 7 is not supported at this time”.

 

Don’t have PowerShell 7?

To find out what version of PowerShell you’re running, simply type $PSVersionTable at the prompt. If you don’t have PowerShell 7 installed yet, you can follow this article for instructions on how to install it.

Categories: Powershell, XM Cloud