This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

How-to guides

The user can enter the required information for the Config Inspection service through the Samsung Cloud Platform Console, select detailed options, and create the service.

Create Certificate

To create and use the Config Inspection service on the Samsung Cloud Platform Console, a prior authentication key generation is required.

Authentication key creation can be done from My Menu > My Info. > Authentication Key Management > Create Authentication Key. For more details, refer to Authentication Key Management.

Reference
  • The expiration period of the authentication key is up to 365 days.
  • To create an authentication key without an expiration date, you must create it permanently.

Config Inspection Create

You can create and use the Config Inspection service in the Samsung Cloud Platform Console.

Reference
The user must belong to the AdministratorGroup user group in order to use the services provided by the Config Inspection service properly.

To create a Config Inspection, follow these steps.

  1. All Services > Security > Config Inspection Click the menu. Navigate to Config Inspection’s Service Home page.
  2. On the Service Home page, click the Create Config Inspection button. You will be taken to the Create Config Inspection page.
  3. Config Inspection creation On the page, enter the inputs required to create the service, and select detailed options.
    • Service Information Input Enter or select the required information in the area.
      Category
      Required or not
      Detailed description
      Diagnosis Type-Automatically set with Console
      CloudRequiredSelect cloud to diagnose
      • SCP: Samsung Cloud Platform
      • AWS: Amazon Web Services
      • Azure: Microsoft Azure
      • Detailed input fields vary depending on the selected cloud type
      Diagnosis Target > Diagnosis NameRequiredName to distinguish the diagnosis target
      • Use the entered value as the resource name
      • Enter within 25 characters using English letters, numbers, and special characters(-, _)
      Diagnostic Target > Diagnostic AccountRequiredConsole information for the diagnostic target
      • Select the Account ID to diagnose from the list
      • If the same Account ID is selected, duplicate application occurs and additional charges will be incurred
      • If AWS is selected, enter the Account ID (12 digits) in the diagnostic account
      • If Azure is selected, enter the Subscription ID (36 characters including letters, numbers, and special characters) in the diagnostic account
      Diagnosis Schedule > ChecklistRequiredAutomatically set when Use Diagnosis Schedule is selected
      Diagnosis Schedule > Diagnosis CycleRequiredSelect Diagnosis Cycle
      • The diagnosis is executed on the selected date according to the specified cycle
      • Monthly is selected, the diagnosis may not be performed on the selected date
        • e.g., selecting the 31st of each month – February has no such date, so the diagnosis is not performed
      Diagnosis Schedule > Start TimeRequiredSelect Diagnosis Start Time
      • Set the hour and minute information to start the diagnosis
      Authentication KeyRequiredSelect authentication key to use for Open API calls
      • Click the **Select** button and choose the appropriate authentication key from the list in the **Select Authentication Key** popup.
      • If there are no selectable authentication keys, click **Authentication Key Management** to create a new authentication key.
      • For detailed information about authentication keys, refer to [Manage Authentication Keys](/userguide/management/iam/how_to_guides/myinfo.md/#인증키-관리하기).
      | Plan | Select | Select the plan to use
      • **Standard**: charge based on the number of diagnoses
      • **Monthly flat-rate**: charge a fixed amount each month regardless of the number of diagnoses (based on up to 30 diagnoses per month)
      • The plan cannot be changed after service application
      |
      Table. Config Inspection Service Information Input Items
    • Additional Information Input area, enter or select the required information.
      Category
      Required or not
      Detailed description
      TagSelectAdd Tag
      • Up to 50 can be added per resource
      • After clicking the Add Tag button, enter or select Key, Value values
      Table. Config Inspection Additional Information Input Items
  4. Summary In the panel, check the detailed information and estimated billing amount you created, and click the Create button.
  • When creation is complete, check the created resources on the Config Inspection List page.

Config Inspection Check detailed information

Config Inspection service allows you to view and edit the full resource list and detailed information. Config Inspection detailed page consists of Details, Tags, Work History tabs.

To view detailed information of the Config Inspection service, follow the steps below.

  1. All Services > Security > Config Inspection Click the menu. Navigate to Config Inspection’s Service Home page.
  2. Click the Config Inspection menu on the Service Home page. You will be taken to the Config Inspection list page.
  3. On the Config Inspection List page, click the resource to view detailed information. You will be taken to the Config Inspection Details page.
    • Config Inspection Detailed page displays status information and additional feature information, and consists of Detailed Information, Tags, Work History tabs.
      CategoryDetailed description
      StatusDisplays the status of Config Inspection
      • Ready: When there is no diagnostic request after service creation (diagnostic request possible)
      • In Progress: When a diagnostic request is in progress (diagnostic request/service termination not possible)
      • Error: When an error occurs in the diagnostic request (diagnostic request possible)
      • Completed: When the diagnostic request is completed successfully (diagnostic request possible)
      Diagnosis RequestButton that can perform Console diagnosis
      Service CancellationButton to cancel the service
      Table. Config Inspection status information and additional functions

Detailed Information

Config Inspection List page allows you to view detailed information of the selected resource and, if necessary, edit the information.

CategoryDetailed description
ServiceService Name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
Resource NameResource Name
Resource IDUnique resource ID in the service
CreatorUser who created the service
Creation date/timeDate/time the service was created
EditorUser who modified the service information
Modification Date/TimeDate/Time when service information was modified
Diagnosis TypeDiagnosis types provided by the service
CloudDiagnosis Target Types
Diagnosis TargetConsole information of the diagnostic target
  • Provides the diagnostic name and diagnostic account information of the diagnostic target
  • If the diagnostic target is AWS or Azure, you can click the Edit icon to modify the diagnostic account
PlanSelected plan type
Recent diagnosis date/timeLast executed diagnostic request date/time
Recent Diagnosis ResultLast executed diagnosis request result
  • Completed: The diagnosis request has been completed successfully
  • Error: The diagnosis request was not completed successfully
    • UNAUTHORIZED: Key permission used for the diagnosis request needs to be verified
    • INVALID_INPUT_VALUE: Input values such as diagnosis account need to be verified
    • CONNECTION_FAIL: Console access control settings need to be verified
    • ETC: Other errors such as diagnosis engine require inquiry through the service desk
※ Diagnosis results can be viewed in the Security > Config Insepction > Report menu
Authentication KeyUser’s authentication key registered at service creation
  • Access Key, user, status information provided
  • Access Key information and edit icon are displayed only to the user who created the authentication key
    • Click the Edit icon to change the authentication key
  • If the authentication key is deleted, it is shown as - status; if expired, shown as Expired
  • Authentication key information (Access Key, status) of resources created by other users is displayed as -
Diagnosis ScheduleDisplay selected diagnosis schedule information
  • If the diagnosis target is SCP, you can click the Edit icon to change the diagnosis schedule.
Table. Config Inspection Detailed Information Tab Items

Tag

Config Inspection List page allows you to view the tag information of selected resources, and you can add, modify, or delete them.

CategoryDetailed description
Tag ListTag List
  • You can view the Key, Value information of tags
  • Up to 50 tags can be added per resource
  • When entering tags, search and select from the previously created Key and Value list
Table. Config Inspection Tag Tab Items

Work History

On the Config Inspection List page, you can view the operation history of the selected resource.

CategoryDetailed description
Work History ListResource Change History
  • Work date and time, Resource ID, Resource name, Work details, Event topic, Work result, Check worker information
Table. Config Inspection Work History Tab Items

Config Inspection Resource Management

If you need to view the status of Config Inspection resources and request a diagnosis, you can perform the task on the Config Inspection List or Config Inspection Details page.

Edit Authentication Key

You can select the authentication key to use for diagnosis for each diagnosis target.

To modify the service’s authentication key, follow the steps below.

  1. All Services > Security > Config Inspection Click the menu. Go to Config Inspection’s Service Home page.
  2. Click the Config Inspection menu on the Service Home page. You will be taken to the Config Inspection list page.
  3. Config Inspection List page, click the resource to edit the authentication key. You will be taken to the Config Inspection Details page.
  4. Check the authentication key and click the Edit icon. The Edit Authentication Key popup window opens.
  5. Edit Authentication Key Select the authentication key to use in the popup window and click the Confirm button.
    CategoryDetailed description
    Authentication KeyAuthentication Key Details
    Creation Date/TimeAuthentication Key Creation Date
    Expiration Date and TimeAuthentication Key Expiration Date
    StatusStatus of the authentication key
    • Use: Usable state
    • Expired: Expired usage period state
    Table. Authentication Key Edit Popup Items
Reference
  • If the authentication key is deleted, it is displayed as - status.
  • The authentication key information (authentication key, status) of resources created by other users is displayed as -.

Request Diagnosis

You can request a console diagnosis based on the configured checklist.

To request a console diagnosis, follow the steps below.

  1. All Services > Security > Config Inspection Click the menu. Go to Config Inspection’s Service Home page.

  2. Click the Config Inspection menu on the Service Home page. You will be taken to the Config Inspection list page.

  3. Config Inspection list page, click the resource to request a diagnosis. Config Inspection details page will be opened.

  4. Click the Diagnostic Request button on the Config Inspection Details page. The Diagnostic Request popup will open.

  5. Diagnosis Request Enter the information required for diagnosis in the popup window and click the Confirm button.

    • Diagnosis Request The items in the popup window vary depending on the selected Console.
      CategoryDetailed description
      Console Access MethodFixed to authentication key method as the way to access the Console
      ChecklistFix as Best Practice when selecting SCP
      Authentication KeyIf SCP is selected, choose the pre-generated authentication key
      Access KeyEnter Access Key if AWS is selected
      Secret KeyEnter Secret Key if AWS is selected
      Client IDEnter Client ID if Azure is selected
      Client SecretEnter Client Secret if Azure is selected
      Tenant IDEnter Tenant ID if Azure is selected
      Table. Diagnosis Request Popup Items
  6. On the Config Inspection List page, check the Status value.

    • When the diagnostic request is completed, the status value is displayed as Completed or Error.
    • Completed: You can view the diagnosis request results in the diagnosis results menu. For more details, see Report Management.
Reference
For detailed information on the prerequisite settings required to run diagnostics per console, refer to Set Up Prerequisites.

Config Inspection Cancel

You can cancel the unused Config Inspection service. However, if you cancel Config Inspection, all stored diagnostic data will be deleted.

Caution
  • If you cancel the resource, all diagnostic data will be deleted, and you will not be able to view the diagnostic results in the Report.
  • Config Inspection service cannot be terminated if its status is In Progress.

To cancel Config Inspection, follow the steps below.

  1. Click the All Services > Security > Config Inspection menu. Go to Config Inspection’s Service Home page.
  2. Click the Config Inspection menu on the Service Home page. Navigate to the Config Inspection List page.
  3. On the Config Inspection List page, click the resource to be terminated. Navigate to the Config Inspection Details page.
  4. Click the Service Termination button on the Config Inspection Details page.
  5. When termination is complete, check on the Config Inspection List page whether the resource has been terminated.

1 - Dashboard Check

Users can view the diagnostic results of the Config Inspection service at a glance on the dashboard through the Samsung Cloud Platform Console.

Check Dashboard

On the dashboard page, you can view the status of Config Inspection’s diagnostic targets and diagnostic history, etc.

To check the dashboard, follow the steps below.

  1. Click the All Services > Security > Config Inspection menu. Navigate to the Service Home page of Config Inspection.
  2. Click the Dashboard menu on the Service Home page. Navigate to the Dashboard page.
  3. Dashboard Check the summary of diagnostic results on the page.
    • Dashboard You can view the dashboard information at the top of the page based on period or diagnosis name.
      • Period: Based on the current month, you can set a period within 6 months to view summary information of the diagnosis results.
      • Diagnosis Name: If you select All, you can view a summary of the entire diagnostic history results, and if you select a diagnostic account, you can view the detailed information of that diagnostic result.
    • Download button can be clicked to download the information displayed on the dashboard page as a PDF file.
      CategoryDetailed description
      Security Level (Overall)Display average of latest diagnostic results for all diagnostic targets
      • Recent diagnostic results are displayed in the list
      • Diagnostic score calculation formula = Total – (Fail + Error + Check)) / Total x 100
      Periodic Diagnosis StatusDisplay diagnosis status by target during search period
      • Diagnosis Completed: Show recent completed diagnosis details
        • Diagnosis Error: Show recent diagnosis error details, when selecting diagnosis name go to detailed result page
        Summary of Diagnosis Results by Period (All)Display summary of diagnosis results (All) during the search period
        • If you select a diagnosis name from the list, you will be taken to the detailed diagnosis result page
        Table. Detailed dashboard item description for overall diagnosis results
        CategoryDetailed description
        Security LevelDisplay the last diagnostic result score of the selected diagnostic account
        • Recent diagnostic results are displayed in the list
        Period-wise diagnostic result summaryShow summary of diagnostic results for the last diagnostic account within the search period
        Vulnerability Status by PeriodDisplay the vulnerability diagnosis results of the diagnostic account during the search period as a graph
        • When a graph is selected, display detailed information of the vulnerable items in the diagnosis results
        Table. Detailed dashboard item description for diagnostic results by diagnostic account

    2 - Diagnostic Result Management

    You can view the Config Inspection diagnostic request results on the diagnostic results page and change the diagnostic results.

    Reference

    The diagnostic result is generated when a diagnostic request is made in the Config Inspection service, and it is deleted when the service is terminated.

    Check diagnosis results

    On the diagnosis results page, you can view the diagnosis request results.

    Check diagnosis result list

    To view the list of diagnostic results, follow the steps below.

    1. All Services > Security > Config Inspection Click the menu. Navigate to the Service Home page of Config Inspection.
    2. Click the Diagnostic Results menu on the Service Home page. You will be taken to the Diagnostic Results List page.
    3. Diagnostic Result List Check the summary information of diagnostic results on the page.
      CategoryDetailed description
      Diagnosis nameResource name
      Diagnostic AccountConsole information to be diagnosed
      ChecklistCollection of diagnostic items that serve as the basis for diagnostic results
      PASSNumber of items in the checklist with diagnosis result PASS (normal)
      FAILNumber of items in the checklist with diagnosis result FAIL (vulnerable)
      CHECKNumber of items in the checklist whose diagnosis result is CHECK (verification needed)
      ERRORNumber of items in the checklist whose diagnosis result is ERROR (diagnosis not possible)
      N/ANumber of items in the checklist where the diagnosis result is N/A (not applicable)
      AllTotal number of checklist items
      Diagnosis ResultDiagnosis Request Result
      • Completed: The diagnosis request has been successfully completed, clicking Completed moves to the detail page
      • Error: The diagnosis request was not successfully completed, error status items cannot view detailed content
      Diagnosis timeDiagnosis request time
      Table. Diagnosis Result List Items

    Check detailed diagnostic result information

    To view detailed information of the diagnosis results, follow the steps below.

    1. Click the All Services > Security > Config Inspection menu. Navigate to the Service Home page of Config Inspection.
    2. Click the Diagnostic Results menu on the Service Home page. It navigates to the Diagnostic Results List page.
    • You can search by entering the diagnosis name in the search area of the Diagnosis Result List page or by clicking the Detailed Search button.
    1. Click on an item with a Completed diagnosis result on the Diagnosis Result List page. You will be taken to the diagnosis result detail page.

      • Items whose diagnostic result is in error state do not display detailed information.
    2. Detailed Diagnosis Results page, check the detailed diagnosis results.

      CategoryDetailed description
      Excel DownloadDownload detailed list of diagnosis results as an Excel file
      More > Diagnosis Result ManagementGo to Diagnosis Result Management page
      ChecklistCollection of diagnostic items that serve as the basis for diagnostic results
      AreaDiagnosis scope (services of Samsung Cloud Platform)
      Diagnostic ItemsSecurity standards recommended for service-specific settings
      ResultResult of diagnostic item criteria check
      Table. Detailed Diagnosis Result Items

    3. Click the diagnostic item to view detailed information. Diagnostic Item Details popup window opens.

      • Diagnosis Item Details In the popup window, you can view the following information.
        CategoryDetailed description
        AreaDiagnosis Scope (Samsung Cloud Platform’s services)
        Diagnostic ItemsSecurity standards recommended for service-specific settings
        ResultDiagnosis item criteria check result
        Diagnosis CriteriaResult Judgment Criteria
        Diagnostic MethodCurrent Settings Check Method
        Action GuideConfiguration method that meets security standards
        Detailed ResultResource information and settings corresponding to the diagnostic item
        Diagnosis Result ChangeButton to change diagnosis result
        • If the diagnosis result is changed, the Check Result button is displayed, and clicking the Delete button allows deletion of the changed result
        Table. Config Inspection Diagnosis Item Details

    Manage Diagnosis Results

    On the diagnosis result page, you can change the results of items whose diagnosis result is in CHECK status.

    Change Diagnosis Result

    To change the diagnosis result, follow the steps below.

    1. All Services > Security > Config Inspection Click the menu. Navigate to the Service Home page of Config Inspection.

    2. Click the Diagnostic Results menu on the Service Home page. It navigates to the Diagnostic Results List page.

    3. Diagnosis Result List page, click the item whose diagnosis result is Completed. You will be taken to the Diagnosis Result Details page.

      • Items with a diagnostic result in error state do not display detailed information.
    4. Click the More > Diagnosis Result Management button at the top of the Diagnosis Result Details page. You will be taken to the Diagnosis Result Management page.

    5. Click the Result Change button for the item whose diagnostic result you want to modify on the Diagnostic Result Management page. The Result Change popup window will open.

    6. Result Change In the popup window, select or enter the information required to change the result.

      CategoryRequired?Detailed description
      Registrant-Diagnosis result change registrant email
      Validity PeriodRequiredSet the validity period of the diagnostic result
      Change ResultRequiredSelect the diagnostic result to change among Pass, Check, Fail
      Detailed ReasonRequiredEnter the detailed reason for changing the result
      Attachment FileSelectUpload files required for confirming result changes
      • Attach File button to upload files, up to 5 can be registered
      Inspection Result-Detailed inspection result display
      Table. Detailed Items of Diagnosis Result Change

    7. Check the entered information and click the Register button. Verify whether the diagnostic results have changed in the Diagnostic Result Management list.

    Delete diagnosis result change history

    To delete the diagnostic result change history, follow the steps below.

    1. All Services > Security > Config Inspection Click the menu. Navigate to Config Inspection’s Service Home page.
    2. Click the Diagnostic Results menu on the Service Home page. Navigate to the Diagnostic Results List page.
    3. Click an item with a completed diagnosis result on the Diagnosis Result List page. It moves to the Diagnosis Result Details page.
      • Items whose diagnostic result is in error state do not display detailed information.
    4. Click the Diagnosis Result Details page’s top Diagnosis Result Management button. It navigates to the Diagnosis Result Management page.
    5. Diagnosis Result Management page, click the Check Result button for the item whose diagnosis result you want to change. The Check Result popup window opens.
    6. Check Results in the popup window, click the Delete button.

    3 - Pre-configuration

    Users must perform cloud pre-configuration such as authentication key creation and access control IP addition through the Samsung Cloud Platform Console to use the Config Inspection service.

    Note
    Items to set vary depending on the type of cloud you use. Refer to the corresponding chapter and set the required items for each cloud.

    Samsung Cloud Platform Console Settings

    To diagnose Samsung Cloud Platform and external clouds in the Config Inspection service, set the following items.

    Check Policies Linked to User Group

    Notice
    • Config Inspection can diagnose Samsung Cloud Platform or external clouds. You can use it by granting appropriate policy requirements to the user group according to the diagnosis target.
      • Check if the user group policy matching your desired diagnosis target is set.
      • If policy creation is required, contact the Account administrator.

    To check the policy of the user group you belong to, follow the procedure below.

    1. Click All Services > Management > IAM menu. You will be redirected to the Service Home page of IAM.
    2. Click User Groups menu on the Service Home page. You will be redirected to the User Group List page.
    3. Click the user group you want to check on the User Group List page. You will be redirected to the User Group Details page.
    4. Click Policies tab on the User Group Details page. You will be redirected to the Policies tab page.
    5. Click the policy you want to check on the Policies tab page. You will be redirected to the Policy Details page.
    6. Check the detailed information on the Policy Details page.
      • Check if the policy information in the table below is set. If necessary, contact the administrator to add the policy.
        ItemPolicy Requirement 1Policy Requirement 2
        ActionList, ReadCreate, Delete, List, Read, Update
        ResourceAll resourcesIndividual resource (Config Inspection)
        Auth TypeAll authenticationTemporary key authentication, Console login
        Allowed IP123.37.11.42, User-defined IP
        • For diagnosis, you must add IP 123.37.11.42 and IP for user console access separately
        User-defined IP
        Table. Policy setting details for diagnosing all clouds

    Create Authentication Key

    You can check and create authentication keys to use in the Config Inspection service.

    Notice
    • You can create only up to 2 authentication keys.
    • After creating a new authentication key, you must apply the changed API authentication key to the service you are using.

    To create an authentication key in Samsung Cloud Platform Console, follow the procedure below.

    1. Click My Menu > My info. menu in the Console. You will be redirected to the My info. details page.
    2. Click Authentication Key Management tab on the My info. details page. You will be redirected to the Authentication Key Management tab page.
    3. Click Create Authentication Key button on the Authentication Key Management tab page. You will be redirected to the Create Authentication Key page.
      • You can check the authentication key list on the authentication key management page.
    4. Enter the expiration period on the Create Authentication Key page and click OK button.
    5. Check if the created authentication key is displayed in the authentication key list.

    Add Access Allowed IP

    You can add access allowed IPs in Samsung Cloud Platform Console.

    To add access allowed IPs in the Console, follow the procedure below.

    1. Click My Menu > My info. menu in the Console. You will be redirected to the My info. details page.
    2. Click Authentication Key Management tab on the My info. details page. You will be redirected to the Authentication Key Management tab page.
    3. Click Edit icon in Security Settings item on the Authentication Key Management tab page. The Edit Authentication Key Security Settings popup will open.
    4. Enter the authentication method and access allowed IP in the Edit Authentication Key Security Settings popup.
      • Select Authentication Key for authentication method.
      • Set access allowed IP to Enable, enter the IP address, and click Add button.
    5. When adding access allowed IP is complete, click OK button. Check if the information is modified to the entered information in the Security Settings item.

    AWS Settings

    To diagnose AWS (Amazon Web Services) cloud in the Config Inspection service, set the following items.

    Add Permission Policy

    You can add permission policies for users/user groups in AWS Console.

    Add User Permission

    To add user access permission policy in AWS Console, follow the procedure below.

    1. Click IAM > Users in AWS Console.
    2. Select the diagnostic user name from the user list.
    3. Click Permissions tab on the user information page.
    4. Select Add permissions in the permission policy.
      • Select ReadOnlyAccess, ViewOnlyAccess when adding permissions.

    Add User Group Permission

    To add user group access permission policy in AWS Console, follow the procedure below.

    1. Click IAM > User groups in AWS Console.
    2. Select the group the user belongs to from the user group list.
    3. Click Permissions tab on the user group page.
    4. Select Add permissions in the permission policy.
      • Select ReadOnlyAccess, ViewOnlyAccess when adding permissions.

    Add Access Control IP

    If using IP access control policy, you must add block exception IPs to that policy.

    Add User Access Control IP

    To add user access control IP in AWS Console, follow the procedure below.

    1. Click IAM > Users in AWS Console.
    2. Select the diagnostic user name from the user list.
    3. Click Permissions tab on the user information page.
    4. Click Edit in IP Access Control Policy in the permission policy item.
      • Add 123.37.24.82 to block exception IP.

    Add User Group Access Control IP

    To add user group access control IP in AWS Console, follow the procedure below.

    1. Click IAM > User groups in AWS Console.
    2. Select the group the user belongs to from the user group list.
    3. Click Permissions tab on the user group page.
    4. Click Edit in IP Access Control Policy in the permission policy item.
      • Add 123.37.24.82 to block exception IP.

    Generate Access Key

    To generate Access Key in AWS Console, follow the procedure below.

    1. Click IAM > Users in AWS Console.
    2. Select the diagnostic user name from the user list.
    3. Click Security credentials tab on the user information page.
    4. Click Access keys on the Security credentials page.
    5. Create access keys for third-party services on the Create access key page.
      • Make sure to save the created access key information.
    Caution

    Download the Secret Key as a csv file or record it separately.

    • Secret key information can only be checked when creating the access key and cannot be recovered later.

    Azure Settings

    To diagnose Azure cloud in the Config Inspection service, set the following items.

    Register Entra ID Application

    To register Entra ID Application in Azure Console, follow the procedure below.

    1. Click Microsoft Entra ID > App registrations in Azure Console.
    2. Click New registration on the App registrations page.
    3. Register application (client) ID.
    4. When app registration is complete, check App name, Application (client) ID, Directory (tenant) ID on the overview page.

    Add API Permission

    Note
    To use Config Inspection service, you must pre-configure with an account granted the Global Administrator role among Azure AD roles.

    To add API permission in Azure Console, follow the procedure below.

    1. Click Microsoft Entra ID > App registrations > Entra ID Application registration > created App name > API permissions > Add a permission in Azure Console.
    2. Select Microsoft Graph to add permissions from the API permissions list.
    3. Click Application permissions on the Request API permissions page.
      • Select Application.Read.All, Device.Read.All, Group.Read.All, User.Read.All, DeviceManagementManagedDevices.Read.All, AuditLog.Read.All, Directory.Read.All, Domain.Read.All, GroupMember.Read.All, Policy.Read.All, Reports.Read.All from the permission list.
    4. After adding permissions in App API permission registration, click Grant admin consent for account name.
      • Check if it changes to Granted for account name status for the account name.

    Create Client Secret

    To create Client Secret in Azure Console, follow the procedure below.

    1. Click Microsoft Entra ID > App registrations > Entra ID Application registration > created App name > Certificates & secrets in Azure Console.
    2. Click New client secret from the Certificates & secrets list.
    3. When client secret is created, check the Client Secret in the Value item from the list.
      • Make sure to save the Client Secret value.
    Caution
    Client Secret value (Value) can only be checked at creation time. Make sure to record or save it separately.

    Add Subscription Access Permission in Azure Console

    You can add subscription access permissions in Azure Console from Tenant Root Group or individual Subscription. Choose your preferred method to add subscription access permissions.

    Add Permission from Tenant Root Group

    To add subscription access permission in Azure Console from Tenant Root Group, follow the procedure below.

    1. Click Management groups > Overview in Azure Console.
    2. Click Tenant Root Group > Access control (IAM).
      • If you cannot enter the Tenant Root Group menu, change the setting below.
        • Change Microsoft Entra ID > Properties > ‘Account name’ can manage access to all Azure subscriptions and management groups in this tenant. > Yes
      • After adding permissions, you must change it to No.
    3. Click Add > Add role assignment on the Access control page.
    4. Enter detailed information on the Add role assignment page and click Review+assign.
      • When entering role assignment information, select the information below from the Role and Member tabs to add the App created in Entra ID Application registration. You must add all three permissions below.
        CategoryPermission
        ReaderUsers, group, or service principal
        Key Vault ReaderUsers, group, or service principal
        Reader and Data AccessUsers, group, or service principal
        Table. Additional permission items when entering role assignment information

    Add Permission from Individual Subscription

    To add subscription access permission in Azure Console from individual Subscription, follow the procedure below.

    1. Click Subscription > Overview in Azure Console.
      • Check Subscription ID from the basic information on the overview page.
    2. Click Subscription > Access control (IAM).
    3. Click Add > Add role assignment on the Access control page.
    4. Enter detailed information on the Add role assignment page and click Review+assign.
      • When entering role assignment information, select the information below from the Role and Member tabs to add the App created in Entra ID Application registration. You must add all three permissions below.
        CategoryPermission
        ReaderUsers, group, or service principal
        Key Vault ReaderUsers, group, or service principal
        Reader and Data AccessUsers, group, or service principal
        Table. Additional permission items when entering role assignment information

    Add Access Permission via PowerShell

    To add subscription access permission in Azure Console using PowerShell, follow the procedure below.

    1. Run the following command in Cloud shell > PowerShell in Azure Console.
      • New-AzRoleAssignment -ObjectId “App’s Object ID confirmed in Enterprise Application” -Scope “/providers/Microsoft.aadiam” -RoleDefinitionName ‘Reader’ -ObjectType ‘ServicePrincipal’
      • If the command does not run, change the setting below.
        • Change Microsoft Entra ID > Properties > ‘Account name’ can manage access to all Azure subscriptions and management groups in this tenant. > Yes
        • After adding permissions, you must change it to No
    2. Run the following command to check if the setting is complete.
      • Get-AzRoleAssignment –ObjectId "App’s Object ID confirmed in Enterprise Application" –Scope "/providers/Microsoft.aadiam"
      • If you need to delete permissions, run the following command.
        • Remove-AzRoleAssignment -ObjectId “App’s Object ID confirmed in Enterprise Application” -Scope “/providers/Microsoft.aadiam” -RoleDefinitionName ‘Reader’