I have seen that PaperCut supports internal users. What about internal Groups?

KB Home   |   I have seen that PaperCut supports internal users. What about internal Groups?

Main.InternalGroups History

Hide minor edits - Show changes to output

July 24, 2019, at 12:54 PM by Chris King - Added LDAP Group search workaround details, and cleaned up wording a little
Changed lines 3-4 from:
Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory, LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additional groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located here for more information (open in a text editor):
to:
Internal Users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory, LDAP, etc.) - I.e they are not synchronised into PaperCut, but are manually created - and like Internal Users PaperCut also has the ability to define Internal Groups - again these are groups internal to the PaperCut system, not synchronised from anywhere, but manually created. 

Internal Groups are also called "additional groups" as they are usually defined
and used 'in addition' to the groups already provided by your domain/directory.  Additional groups are defined in a text file and may be composed of users who exist either in the domain or are PaperCut Internal Users. 

We have created a useful template of this text file, to show you how it works. This template is included within the Program Files of PaperCut on your PaperCut server.
See the comments in the text file located here for more information (open in a text editor):
Changed lines 11-14 from:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file, remember to save it as [@additional-groups.txt@] then restart the PaperCut Application Server service. Then log into the PaperCut Admin console, go to the Groups tab and click on the "Add/Remove groups" button to find your new groups.

In
the [@additional-groups.txt@]  file, you'll need to have a username associated with the group for it to show under the Groups tab in the PaperCut Admin console.
to:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file to use as your active file for Internal Groups, remember to save it as [@additional-groups.txt@] then '''restart the PaperCut Application Server service'''. Then you can log into the PaperCut Admin console, go to the Groups tab and click on the "Add/Remove groups" button to find your newly created groups.

In the [@additional-groups.txt@]  file, you'll need
to have a username associated with the group for it to show under the Groups tab in the PaperCut Admin console.  The format of additional-groups.txt is a simple, tab-delimited list of groups and their associated users, with one group and one user, per line, eg:
group-1johnnie
group-1kelly schultz
group-2johnnie

Changed lines 20-21 from:
One of the main use cases of using additional/extra groups in this file is to supplement groups in the user directory.  In large education environments, getting new groups defined in a central directory server can be difficult - need to convince the central administrator that the group is required and should be maintained.  This method allows groups to be created by say a department admin without the need to have admin-level access to the central LDAP/AD server.
to:
One of the main use cases of using additional/extra groups in this file is to supplement groups in the user directory.  In large education environments, getting new groups defined in a central directory server can be difficult - you need to convince the central administrator that the group is required and needs to be maintained.  The manual file method allows groups to be created or controlled by a wider range of people without the need to have admin-level access to the central LDAP/AD server.
Added lines 23-31:

!!If you want to bypass the LDAP lookup for adding Groups, and only use the file

Some customers who use LDAP for authentication nonetheless prefer to define their groups solely by using the additional-groups.txt file method instead of relying on LDAP. and we can help you achieve this!

If you prefer to prevent any LDAP searches while executing Add/Remove Groups, you can set the optional advanced configuration key called “user-source.group-list-override-file” to  a value of Y.
This config key in found in the Config Editor in - Options > Actions > Config editor (advanced).

February 07, 2018, at 05:09 AM by Mel Zouzoulas - Added some more info
Changed lines 7-11 from:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file remember to save it as [@additional-groups.txt@] then restart the PaperCut Application Server service. Then log into the PaperCut Admin console, go to the Groups tab and click on the "Add/Remove groups" button to find your new groups.

In the [@additional-groups.txt@]  file, you'll need to have a username associated with the group for it to show under the Groups tab.

PaperCut will read this file when it detects a change has been made,
and then caches the contents in memory.
to:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file, remember to save it as [@additional-groups.txt@] then restart the PaperCut Application Server service. Then log into the PaperCut Admin console, go to the Groups tab and click on the "Add/Remove groups" button to find your new groups.

In the [@additional-groups.txt@]  file, you'll need to have a username associated with the group for it to show under the Groups tab in the PaperCut Admin console.

PaperCut will read this file when it detects a change has been made
and then caches the contents in memory.
February 07, 2018, at 05:07 AM by Mel Zouzoulas - Added some more info
Changed lines 7-9 from:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file remember to save it as [@additional-groups.txt@] then restart the PaperCut Application Server service. Then log into the PaperCut Admin console, go to the Groups tab and click on the "Add/Remove groups" button to find your new groups. In the [@additional-groups.txt@]  file, you'll need to have a username associated with the group for it to show under the Groups tab.
to:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file remember to save it as [@additional-groups.txt@] then restart the PaperCut Application Server service. Then log into the PaperCut Admin console, go to the Groups tab and click on the "Add/Remove groups" button to find your new groups.

In the [@additional-groups.txt@]  file, you'll need to have a username associated with the group for it to show under the Groups tab.
February 07, 2018, at 05:06 AM by Mel Zouzoulas - Added some more info
Changed lines 3-4 from:
Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory , LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additional groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located here for more information (open in a text editor):
to:
Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory, LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additional groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located here for more information (open in a text editor):
Changed lines 7-9 from:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file remember to save it as [@additional-groups.txt@]

PaperCut will read this file when it detects a change has been made
, and then caches the contents in memory.
to:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file remember to save it as [@additional-groups.txt@] then restart the PaperCut Application Server service. Then log into the PaperCut Admin console, go to the Groups tab and click on the "Add/Remove groups" button to find your new groups. In the [@additional-groups.txt@]  file, you'll need to have a username associated with the group for it to show under the Groups tab.

PaperCut will read this file when it detects a change has been made,
and then caches the contents in memory.
March 28, 2017, at 03:09 AM by Alec - Added a note about catching contents
Added lines 9-10:
PaperCut will read this file when it detects a change has been made, and then caches the contents in memory.
Deleted lines 11-12:

October 19, 2015, at 08:48 PM by timg - added keyword
Changed line 18 from:
[-keywords: groups, group, internal, extra-]
to:
[-keywords: groups, group, internal, extra, local groups-]
Changed lines 9-12 from:
One of the main use cases of using additional/extra groups in this file is to supliment groups in the user directory.  In large education environments, getting new groups defined in a central directory server can be difficult - need to convince the central administrator that the group is required and should be maintained.  This method allows groups to be created by say a department admin without the need to have admin-level access to the central LDAP/AD server.


to:
One of the main use cases of using additional/extra groups in this file is to supplement groups in the user directory.  In large education environments, getting new groups defined in a central directory server can be difficult - need to convince the central administrator that the group is required and should be maintained.  This method allows groups to be created by say a department admin without the need to have admin-level access to the central LDAP/AD server.


Changed lines 7-8 from:
'''Note: If you are editing the additional-groups.txt.tmpl file remember to save it as additional-groups.txt'''
to:
'''Note: ''' If you are editing the additional-groups.txt.tmpl file remember to save it as [@additional-groups.txt@]

One of the main use cases of using additional/extra groups in this file is to supliment groups in the user directory.  In large education environments, getting new groups defined in a central directory server can be difficult - need to convince the central administrator that the group is required and should be maintained.  This method allows groups to be created by say a department admin without the need to have admin-level access to the central LDAP/AD server.


March 04, 2011, at 05:48 PM by Rick - clarified file name
Added lines 7-8:
'''Note: If you are editing the additional-groups.txt.tmpl file remember to save it as additional-groups.txt'''
Added lines 9-11:
----
''Categories:'' [[Category.Users|+]]
----
February 02, 2011, at 05:34 PM by Rick - added group to the keywords
Changed line 9 from:
[-keywords: groups, internal, extra-]
to:
[-keywords: groups, group, internal, extra-]
Changed lines 3-4 from:
Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory , LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additionial groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located here for more information (open in a text editor):
to:
Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory , LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additional groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located here for more information (open in a text editor):
Changed lines 3-8 from:
Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory , LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additionial groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located at:

[@[app-path]/server/data/conf/additional-groups.txt.tmpl@] file for more information (open in a text editor).

Some additional discussion can be found
[[https://www.papercut.com/products/ng/manual/ch-user-mgmt.html|here]].
to:
Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory , LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additionial groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located here for more information (open in a text editor):

->[@[app-path]/server/data/conf/additional-groups.txt.tmpl@]

Some additional discussion can be found
in the manual [[https://www.papercut.com/products/ng/manual/ch-user-mgmt.html|here]].
Added lines 1-9:
(:title I have seen that PaperCut supports internal users.  What about internal Groups?:)

Internal users are users that are defined in the PaperCut system outside of the network user directory source (e.g. Active Directory , LDAP, etc.).  PaperCut also has the ability to define internal user groups - again these are groups internal to the PaperCut system.  Internal groups are also called "additional groups" as they are usually defined/used in addition to the groups already provided by your domain/directory.  Additionial groups are defined in a text file and may be composed of members who exist either in the domain or are PaperCut internal users.  See the comments in the text file located at:

[@[app-path]/server/data/conf/additional-groups.txt.tmpl@] file for more information (open in a text editor).

Some additional discussion can be found [[https://www.papercut.com/products/ng/manual/ch-user-mgmt.html|here]].

[-keywords: groups, internal, extra-]

Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.

Article last modified on July 24, 2019, at 12:54 PM
Printable View   |   Article History   |   Edit Article