Controlling Access to Task Logs

ENTERPRISE

Managing user access to task logs using Marathon groups

You can control user access to task logs by using Marathon groups for jobs and services. You can then assign permissions to access these groups, allowing you to control which logs a user can access.

IMPORTANT: The functionality described in this document is only available in strict security mode.

In this procedure, you will deploy services in separate Marathon groups, and grant user permissions to view the tasks for these Marathon groups.

Here is an overview of the permissions that are required:

Permission stringfullCRUD
dcos:adminrouter:ops:mesos
Controls access to the Mesos master UI and API.		x
dcos:adminrouter:ops:slave
Controls access to the Mesos agent UI and API.		x
dcos:mesos:agent:executor:app_id[:<service-or-job-group>]
Controls view access to service and job executor information.		x
dcos:mesos:agent:framework:role[:<role-name>]
Controls view access to DC/OS services registered with a particular role.		x
dcos:mesos:agent:sandbox:app_id[:<service-or-job-group>]
Controls access to the Mesos sandbox.		x
dcos:mesos:agent:task:app_id[:<service-or-job-group>]
Controls access to task information.		x
dcos:mesos:master:executor:app_id[:<service-or-job-group>]
Controls access to executor service and job groups.		x
dcos:mesos:master:framework:role[:<role-name>]
Controls access, by role, to register as a framework with Mesos.		x
dcos:mesos:master:task:app_id[:<service-or-job-group>]
Controls access to run tasks.		x

Prerequisites:

  • DC/OS and DC/OS CLI are installed and you are logged in as a superuser.

Via the DC/OS web interface

Create the groups and grant permission

  1. Select Organization and choose Groups.

    New group

    Figure 1. New user group

  2. Create a new group.

    Prod group

    Figure 2. Create new group screen

  3. Select the group name and from the Permissions tab, click ADD PERMISSION.

    Add permission to prod-group

    Figure 3. Add Permission button

  4. Click INSERT PERMISSION STRING to toggle the dialog, and then paste in the following permissions and click ADD PERMISSIONS.

    1. dcos:adminrouter:ops:mesos full
    2. dcos:adminrouter:ops:slave full
    3. dcos:mesos:agent:executor:app_id:/prod-group/ read
    4. dcos:mesos:agent:framework:role:slave_public/ read
    5. dcos:mesos:agent:sandbox:app_id:/prod-group/ read
    6. dcos:mesos:agent:task:app_id:/prod-group/ read
    7. dcos:mesos:master:executor:app_id:/prod-group/ read
    8. dcos:mesos:master:framework:role:slave_public/ read
    9. dcos:mesos:master:task:app_id:/prod-group/ read

    Add permission

    Figure 4. Permissions string added

Create the users and grant permission

  1. Select Organization and choose Users. Select an existing or create a new user.

    New user

    Figure 5. Users screen

  2. From the Group Membership tab, type in the search box and choose the group name. This will grant the group permissions to an individual user.

    Add alice to security group

    Figure 6. Adding user to security group

Launch apps in the user groups

This section shows you how to deploy a simple application in your group.

  1. Select Services > RUN A SERVICE.

  2. Select Single Container and define your service as:

    • SERVICE ID Specify /<gid>/<service-name>. This creates a service within a service group.
    • COMMAND Specify sleep 1000000000.
    • Container Runtime Select UNIVERSAL CONTAINER RUNTIME (UCR).

    Define nested service

    Figure 7. Define a nested service

  3. Click REVIEW & RUN and RUN SERVICE to complete your installation. You should now see a service that is running in a group.

    Service running within group

    Figure 8. Service running in a group

Now you can verify access.

Via the IAM API

Prerequisite: You must get the root cert before issuing the curl commands in this section.

Tips

  • Service resources often include / characters that must be replaced with %252F in curl requests, as shown in the examples below.
  • When using the API to manage permissions, you must create the permission before granting it. If the permission already exists, the API will return an informative message and you can continue to assign the permission.

Create the User Groups and Launch App

  1. Use the following command to create a Marathon group (<gid>).

    1. curl -X POST --cacert dcos-ca.crt \
    2. $(dcos config show core.dcos_url)/service/marathon/v2/groups \
    3. -d '{"id":"<gid>"}' \
    4. -H "Content-type: application/json" \
    5. -H "Authorization: token=$(dcos config show core.dcos_acs_token)"

  2. Use the following command to deploy a simple application (<service-name>) inside of <gid>.

    1. curl -X POST --cacert dcos-ca.crt \
    2. $(dcos config show core.dcos_url)/service/marathon/v2/apps \
    3. -d '{"id":"/<gid>/<service-name>","cmd":"sleep 1000000000"}' \
    4. -H "Content-type: application/json" \
    5. -H "Authorization: token=$(dcos config show core.dcos_acs_token)"

Create and grant the permissions

  1. Use the following commands to create the permissions for your group (<gid>).

    1. curl -X PUT --cacert dcos-ca.crt \
    2. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    3. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:adminrouter:ops:mesos \
    4. -d '{"description":"Grants access to the Mesos master API/UI and task details"}'
    5. curl -X PUT --cacert dcos-ca.crt \
    6. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    7. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:adminrouter:ops:slave \
    8. -d '{"description":"Grants access to the Mesos agent API/UI and task details such as logs"}'
    9. curl -X PUT --cacert dcos-ca.crt \
    10. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    11. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:master:framework:role:slave_public \
    12. -d '{"description":"Grants access to register as or view Mesos master information about frameworks registered with the slave_public role"}'
    13. curl -X PUT --cacert dcos-ca.crt \
    14. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    15. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:master:executor:app_id:%252F<gid> \
    16. -d '{"description":"Controls access to executors running inside <gid>"}'
    17. curl -X PUT --cacert dcos-ca.crt \
    18. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    19. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:master:task:app_id:%252F<gid> \
    20. -d '{"description":"Grants access to the tasks on the Mesos master that are running inside of <gid>"}'
    21. curl -X PUT --cacert dcos-ca.crt \
    22. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    23. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:framework:role:slave_public \
    24. -d '{"description":"Grants access to view Mesos agent information about frameworks registered with the slave_public role"}'
    25. curl -X PUT --cacert dcos-ca.crt \
    26. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    27. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:executor:app_id:%252F<gid> \
    28. -d '{"description":"Grants access to executors running on the Mesos agent inside <gid>"}'
    29. curl -X PUT --cacert dcos-ca.crt \
    30. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    31. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:task:app_id:%252F<gid> \
    32. -d '{"description":"Grants access to tasks running on the Mesos agent inside <gid>"}'
    33. curl -X PUT --cacert dcos-ca.crt \
    34. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" \
    35. -H 'Content-Type: application/json' $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:sandbox:app_id:%252F<gid> \
    36. -d '{"description":"Grants access to the sandboxes on the Mesos agent inside <gid>"}'

  2. Use the following commands to grant the permissions to the user (<username>). These will allow her to view the task logs in <gid>.

    1. curl -X PUT --cacert dcos-ca.crt \
    2. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:adminrouter:ops:mesos/users/<username>/full
    3. curl -X PUT --cacert dcos-ca.crt \
    4. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:adminrouter:ops:slave/users/<username>/full
    5. curl -X PUT --cacert dcos-ca.crt \
    6. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:master:framework:role:slave_public/users/<username>/read
    7. curl -X PUT --cacert dcos-ca.crt \
    8. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:master:executor:app_id:%252F<gid>/users/<username>/read
    9. curl -X PUT --cacert dcos-ca.crt \
    10. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:master:task:app_id:%252F<gid>/users/<username>/read
    11. curl -X PUT --cacert dcos-ca.crt \
    12. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:framework:role:slave_public/users/<username>/read
    13. curl -X PUT --cacert dcos-ca.crt \
    14. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:executor:app_id:%252F<gid>/users/<username>/read
    15. curl -X PUT --cacert dcos-ca.crt \
    16. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:task:app_id:%252F<gid>/users/<username>/read
    17. curl -X PUT --cacert dcos-ca.crt \
    18. -H "Authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:mesos:agent:sandbox:app_id:%252F<gid>/users/<username>/read

Now you can verify access.

Verifying Access

  1. Log into the DC/OS CLI as the user.

    1. dcos auth login

  2. Run this command to access the logs for a service which the user has access.

    1. dcos task log --follow <service-name>

    For example, if your service name is alice-service:

    1. dcos task log --follow alice-service

    The output should resemble:

    1. Executing pre-exec command '{"arguments":["mesos-containerizer","mount","--help=false","--operation=make-rslave","--path=\/"],"shell":false,"value":"\/opt\/mesosphere\/active\/mesos\/libexec\/mesos\/mesos-containerizer"}'
    2. Executing pre-exec command '{"shell":true,"value":"mount -n -t proc proc \/proc -o nosuid,noexec,nodev"}'
    3. Executing pre-exec command '{"arguments":["mount","-n","-t","ramfs","ramfs","\/var\/lib\/mesos\/slave\/slaves\/151ee739-d2b9-4024-8dbd-1345148774df-S1\/frameworks\/151ee739-d2b9-4024-8dbd-1345148774df-0001\/executors\/dev-group_alice-service.363072a5-65b5-11e7-a133-1a6ac27c9efe\/runs\/b46bea37-f3bb-4d9b-b0b9-00b1215c8404\/.secret-48e7541e-6634-4c25-9185-986255249439"],"shell":false,"value":"mount"}'

    If you do not have the correct permissions, you will see this output:

    1. You are not authorized to perform this operation