> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkmk

> Follow these steps to connect Checkmk with StackOne Hub successfully.

<Warning>
  Ensure you have Administrator privileges for your Checkmk Dashboard.
</Warning>

If you've been directed to StackOne to integrate with Checkmk, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Get Your Checkmk Site URL

<Steps>
  <Step title="Log in to Checkmk Dashboard">
    Log in to your Checkmk Dashboard. Your Site URL will consist of the host name with site name and protocall as : `{{Protocall}}://{{Host name}}/{{Site name}}`

    For example: `https://myhost/mysite/check_mk/index.py?start_url=%2Fmysite%2Fcheck_mk%2Fdashboard.py`

    The Site URL is <b>[https://myhost/mysite](https://myhost/mysite)</b>.
  </Step>
</Steps>

## Get user credentials

You will need to provide a Username, Password and Site URL. It is recommended that you set up a new account for integration purposes.

<Steps>
  <Step title="Log in to Checkmk">
    Log in to your Checkmk Dashboard.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Login" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/checkmk/image1.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=af5fcbf16c9cbf76d6d13a27517f71aa" width="395" height="350" data-path="images/checkmk/image1.png" />
    </Frame>
  </Step>

  <Step title="Go to Setup">
    Click on the `Setup` <Icon icon="gear" iconType="regular" /> button from the left menu and then click on the `Users` under <b>Users</b> tab.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Settings" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/checkmk/image2.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=94c9de734ec252a7e505f1155f183bb0" width="818" height="790" data-path="images/checkmk/image2.png" />
    </Frame>
  </Step>

  <Step title="Create a New User">
    Click the `➕ Add user` to create a new User.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="New User" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/checkmk/image3.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=10d87258e622c17122b287a335147650" width="643" height="150" data-path="images/checkmk/image3.png" />
    </Frame>
  </Step>

  <Step title="Fill Out Required Fields">
    Fill out the required fields including username and password and add the Role `Administrator`. This will ensure the account has the correct permissions, and then click `Save` button at top left corner.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Set Role" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/checkmk/image4.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=133fb02d4f6554f542c84da3228df600" width="1806" height="842" data-path="images/checkmk/image4.png" />
    </Frame>
  </Step>
</Steps>

## Connecting to StackOne

<Steps>
  <Step title="Enter User Details">
    Upon reaching the Link Account page, enter the Username, Password and Site URL from the previous step. Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/checkmk/image5.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=2c85b8f04f5bca4c99438f7378e781d2" width="364" height="580" data-path="images/checkmk/image5.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
</ul>

## Useful Links

<Card title="The Checkmk REST API" icon="link" href="https://docs.checkmk.com/latest/en/rest_api.html">
  [https://docs.checkmk.com/latest/en/rest\_api.html](https://docs.checkmk.com/latest/en/rest_api.html)
</Card>

<Card title="User management" icon="link" href="https://docs.checkmk.com/latest/en/wato_user.html">
  [https://docs.checkmk.com/latest/en/wato\_user.html](https://docs.checkmk.com/latest/en/wato_user.html)
</Card>