Self Service

Making Scripts and Apps Available in Self Service

Both custom scripts and custom apps can be made available via Iru Self Service. Use the --self-service option on iructl script new or iructl app new to publish a resource, --category to choose its Self Service category, and --recommended to recommend it. (Profiles are not shown in Self Service.)

By default, if the --category option is not provided, iructl falls back to a default category per resource type: the Utilities category for scripts and the Apps category for apps. These categories are present by default on all Iru tenants. If the default category was deleted or renamed, an error will be raised and you will need to provide a category.

Note

Apps configured with --enforcement no_enforcement (install on demand only) are automatically shown in Self Service, (the Iru API requires it) so iructl sets show_in_self_service for you even without passing --self-service.

Tip

To see or add additional Self Service categories, head to your Iru tenant and go to Settings > Self Service.

More info - Self Service Settings KB

Using the --self-service option

iructl script new --name ss_script_no_category --self-service

The above command tells iructl to create a new custom script Library Item called ss_script_no_category and make that custom script available in Self Service under the Utilities category.

If we take a look at the associated info file, we see that show_in_self_service is set to true and the self_service_category_id is set to Utilities.

<dict>
    <key>active</key>
    <false/>
    <key>execution_frequency</key>
    <string>once</string>
    <key>id</key>
    <string>2b95fd99-06ec-4492-a934-e44ab8e113e9</string>
    <key>name</key>
    <string>ss_script_no_category</string>
    <key>restart</key>
    <false/>
    <key>self_service_category_id</key>
    <string>Utilities</string>
    <key>self_service_recommended</key>
    <false/>
    <key>show_in_self_service</key>
    <true/>
</dict>

Using the --self-service and --category options

iructl script new --name ss_script_option --self-service --category Apps

The above command tells iructl to create a new custom script Library Item called ss_script_option and make that custom script available in Self Service under the Apps category.

Looking at the associated info file, we see that show_in_self_service is set to true and the self_service_category_id is set to Apps.

<dict>
    <key>active</key>
    <false/>
    <key>execution_frequency</key>
    <string>once</string>
    <key>id</key>
    <string>2b95fd99-06ec-4492-a934-e44ab8e113e9</string>
    <key>name</key>
    <string>ss_script_option</string>
    <key>restart</key>
    <false/>
    <key>self_service_category_id</key>
    <string>Apps</string>
    <key>self_service_recommended</key>
    <false/>
    <key>show_in_self_service</key>
    <true/>
</dict>

Publishing an App

Apps use the same options. The following command creates a custom app and makes it available in Self Service under the Productivity category:

iructl app new --file /path/to/MyApp.pkg --name "My App" --self-service --category Productivity

If --category is omitted, the app is published under the default Apps category instead of the script default of Utilities.

Check out iructl script new --help and iructl app new --help for additional usage details.