EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

KB483519: The System Administration Rest API calls fails with the usual credentials : "HTTP Status 401"


Community Admin

• Strategy


This article describes a expected behavior encountered when trying to make a URL API call from the "System Administration" family. When passing the usual Microstrategy credentials, it indicates that the authentication has failed.

Description


Among the Rest API calls, there are some calls under the "System Administration" family: 

ka04W000001Ix4xQAC_0EM2R000000lUHq.jpeg

A developer may, for example, implement a test connection between the Intelligence Server and the REST server, using "/admin/restServerSettings/iServer/connectionTest": 
However, using your Strategy credentials causes the error "401 - Authentication required" to appear.
 

Steps to Reproduce


1. Make a call on one of the System Admin Rest API calls, for example, /admin/restServerSettings/iServer/connectionTest, (Post) 

ka04W000001Ix4xQAC_0EM2R000000lUo6.jpeg

2. Enter your Strategy examples (via for example  basic HTTP authentication using cURL).
Notice the call returns a 401 code. This behavior does not occur with the other family of calls, where the usual Micrsotrategy credentials work.

ka04W000001Ix4xQAC_0EM2R000000lV15.jpeg

Why is this happening?


This is working as expected. The System Administrator API calls returns sensitive data, as such it requires more restrained credentials. To use these calls, it requires the Web Admin credentials.
 

Solution


Since Rest API requires a J2EE application server as a server, use the credentials corresponding to the Web Admin role to use this call.
For example, when you try out the demo Rest URL API under /admin/restServerSettings/collaboration/connectionTest, it prompts you for the Web Admin credentials: 

ka04W000001Ix4xQAC_0EM2R000000lV5C.jpeg

Comment

0 comments

Details

Knowledge Article

Published:

July 30, 2019

Last Updated:

November 15, 2019