Macro Security to Control User Macros - 4.x

Macro Security to Control User Macros - 4.x

Description

The macro-security macro is primarily a tool for administrators to enable usage control of user macros. When included in the logic of a user macro, it can be used to control who can edit content containing the user macro in a manner very similar to how other macro security controlled macros work.

Macro Security macro

The Macro Security macro is generally not used directly on a page. Instead, it is used within a user macro to enforce any restrictions for that user macro as configured by a Confluence Administrator.

For testing purposes, you may wish to temporarily add the Macro Security macro to a page. To do this, type the entire markup shortcut in the editor to insert it, as the Macro Security macro is deliberately not visible in the Macro Browser.

Markup Shortcut

{macro-security}

Screenshot

Parameters

The Macro Security macro accepts 3 parameters.

Parameter

Default

Macro Browser Label

Description

name

<required>

Macro name

The name to use as the primary lookup in the macro security configuration to see if this particular use is allowed.

parameter


Parameter name

Used to further qualify the security lookup when a Parameter Restriction is defined. Leave blank if not needed. Normally represents a macro parameter name.

parameterValue


Parameter value

Used to further qualify the security lookup when a Parameter Restriction is defined. Leave blank if not needed. Only valid if a parameter name is provided. Normally represents a macro parameter value when specific values need to have secured use.

Need support? Create a request with our support team.

Copyright © 2005 - 2025 Appfire | All rights reserved.