Diff for "TechDocs/TechnicalProcesses/NewPeople"

Differences between revisions 14 and 37 (spanning 23 versions)
Revision 14 as of 2018-04-11 10:14:56
Size: 3859
Editor: max.mehl
Comment: add format for different groups
Revision 37 as of 2021-01-04 14:14:40
Size: 6136
Editor: max.mehl
Comment: update xmpp
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Admin tasks to do when someone joins or leave FSFE. This can be volunteer core team members, interns, staff, or GA members. ## page was renamed from TechDocs/TechnicalProcesses/UserCreationAndDeletion
#pragma section-numbers 2
Line 3: Line 4:
= When someone joins = = Processes for joining or leaving team members =
Line 5: Line 6:
=== Supporter account === Admin tasks to do when someone joins or leaves the FSFE. This can be volunteer core team members, interns, staff, or GA members.
Line 7: Line 8:
Go to this page [[https://wiki.fsfe.org/KnowHow/FSFELife/VolunteerAccountCreation|VolunteerAccountCreation]] and create him / her a new supporter account. If the person leaves the FSFE or her employment ends, you have to revert most or all steps.
Line 9: Line 10:
=== Mailing lists === == FSFE account ==

If the person doesn't have an FSFE account yet, ask her to create a new account by becoming [[https://fsfe.org/join|supporter]] or [[https://wiki.fsfe.org/KnowHow/FSFELife/VolunteerAccountCreation|volunteer]].

In the latter case, the account has to be manually activated. Ask them to write an email to contact@fsfe.org to make the account managers aware of it. They should then report back to you to allow you to execute the next steps.

== Mailing Lists ==
Line 15: Line 22:
''System Hackers'': system-hackers@<<BR>>
Line 17: Line 25:
On cavendish, you can run `/root/bin/scan-mlist-member user@fsfe.org` to check a person's membership of possibly sensible mailing lists. On the server list1, you can run `find_member user@fsfe.org` to check a person's membership of possibly sensible mailing lists.
Line 19: Line 27:
=== Welcome message === == LDAP team group ==
Line 21: Line 29:
Send the "welcome message" (see
Services/Internal/UserManagement/welcome_template.txt in the technology SVN
repository) to the new team member, replacing the `FILLME` placeholders with
proper values.
Add the new team member (being in the European core team, an intern or an employee) to the "team" group in the LDAP database
Line 26: Line 31:
=== LDAP team group ===

Add the new team member to the "team" group in the LDAP database

Log into the LDAP server and run
Log into the LDAP server (berzelius) and run
Line 36: Line 37:
Look for the "team" entry and add a "member" attribute for the new member
(if the person is also a GA member, also add him to the "ga" entry)
For each CN, there is a separate section. Add the person to the appropriate sections.
Line 39: Line 39:
More info about ldapvi at: SVN:/sysadmin/Documentation/Services/LDAP/ldap_admin.txt ''Team'': team<<BR>>
''Intern/Employee'': team, staff<<BR>>
''System Hackers'': sysadm<<BR>>
''GA'': team, ga
Line 41: Line 44:
=== Access to the wiki internal pages === More info about ldapvi in the [[https://git.fsfe.org/fsfe-system-hackers/documentation/src/branch/master/SERVICES/LDAP|syshackers documentation]].
Line 43: Line 46:
Add the new team member to the wiki page [[https://wiki.fsfe.org/Group/Team|Group/Team]]. For GA members, repeat the same with [[https://wiki.fsfe.org/Group/GA|Group/GA]].
Please note that usernames are case sensitive!
== Access to the wiki internal pages ==
Line 46: Line 48:
This page defines a group of wiki users that have access to In order to allow users to access restricted pages, you have to add them to Wiki groups by adding their FSFE accout name in a list. Please note that usernames are case sensitive!

These pages define a group of wiki users that have access to
Line 51: Line 55:
=== Jabber: access to chitchat === ''Team'': [[https://wiki.fsfe.org/Group/Team|Group/Team]]<<BR>>
''Intern/Employee'': [[https://wiki.fsfe.org/Group/Team|Group/Team]]<<BR>>
''GA'': [[https://wiki.fsfe.org/Group/Team|Group/Team]], [[https://wiki.fsfe.org/Group/GA|Group/GA]]
Line 53: Line 59:
Add the jabberid to the access list of the chitchat room
(can be done via jabber client)
== XMPP/Jabber ==
Line 56: Line 61:
=== SVN repositories === Employees have to and interested core team members can be member of the ''chitchat'' XMPP room.
Line 58: Line 63:
Add the new member to the "fsfe-team" list in the file auer:/etc/apache2/svn/svnaccess. Please note that usernames are case sensitive! Room moderators have to add the jabberid to the access list of the room. This can be done via XMPP clients. Please note that the Jabber account has to exist.
Line 60: Line 65:
Internal SVN repository: point the person to the usage instructions at
[[https://wiki.fsfe.org/Internal/SVN]].
''Intern/Employee'' (mandatory): chitchat<<BR>>
''Team/GA'' (optional): chitchat<<BR>>
''System Hackers'': syshackers
Line 63: Line 69:
=== Git repository === == OTRS ==
Line 65: Line 71:
Team members shall be added to [[https://git.fsfe.org/org/FSFE/teams/team|FSFE/team]]. GA members are additionally to be added to [[https://git.fsfe.org/org/fsfe-ga/teams/members|FSFE-GA/members]], employees to [[https://git.fsfe.org/org/FSFE/teams/staff|FSFE/staff]]. OTRS is our [[https://tickets.fsfe.org/otrs/index.pl|ticket system]]. Please
add the person to the relevant queues.

''Team'': depends on individual interests and positions<<BR>>
''Intern'': Shipping<<BR>>
''Employee'': depending on work areas<<BR>>
''System Hackers'': System Administrators<<BR>>
''GA'': depends on individual interests and positions

Please follow
[[http://wiki.fsfe.org/TechDocs/TicketSystem/Administration#Grant_access_to_OTRS|this procedure]] and
[[http://doc.otrs.com/doc/manual/admin/5.0/en/html/administration.html#adminarea-agents-groups-and-roles|this one]].

If a person leaves, please make sure to transfer ownership of the remaining open tickets to someone else.

== Git / Gitea teams ==

Since some of our files and knowledge resides on git.fsfe.org, new people have to be added to some teams in order to access their repositories. Please note that you can only add users who logged in to Gitea at least once.

''Team'': [[https://git.fsfe.org/org/FSFE/teams/team|FSFE/team]]<<BR>>
''Intern/Employee'': [[https://git.fsfe.org/org/FSFE/teams/team|FSFE/team]], [[https://git.fsfe.org/org/FSFE/teams/staff|FSFE/staff]]<<BR>>
''System Hackers'': [[https://git.fsfe.org/org/fsfe-system-hackers/teams/systemhackers|fsfe-system-hackers/systemhackers]]<<BR>>
''GA'': [[https://git.fsfe.org/org/FSFE/teams/team|FSFE/team]], [[https://git.fsfe.org/org/fsfe-ga/teams/members|FSFE-GA/members]]

== Wekan ==

Some groups use Kanboard extensively.

''Intern/Employee'': [[https://kan.fsfe.org/b/6dQHBrQhnmfcwKNd6/weekly-planing|Weekly Staff Planning]], [[https://kan.fsfe.org/b/WkomntMjpnkBebXoR/retrospective-2017-10-19|Retrospective]]<<BR>>
''System Hackers'': [[https://kan.fsfe.org/b/M5seFnLuKnGQ6Qwa7/syshackers|System Hackers]]

Please note that when removing a person from a huge board with many (also archived) cards, the process might take quite long. Do not close the board immediately but wait for Wekan going through all cards and removing the person from them.

== Nextcloud ==

Some groups use our Nextcloud installation. Most groups are synced with LDAP, so no need for you to do anything here.

== Passbolt ==

Select teams have access to our Passbolt installation which is independent of LDAP or other services.

New users can be invited from within the web interface, and afterwards added to their respective fine-grained groups. Removed users can just be deleted altogether.

It might make sense to rotate the preceding HTTP Basic Auth Password once in a while.

== Welcome message ==

Send the [[TechDocs/TechnicalProcesses/NewPeople/WelcomeMail|Welcome Message]] to the new team member, replacing the `FILLME` placeholders with proper values.
Line 69: Line 122:
=== Mailing lists === Please do the opposite for all the things explained above.
Line 71: Line 124:
Remove the person from team@, staff@ mailing lists, and possibly ga@ as well for leaving GA members. System Hackers coordinators and the FSFE Council can review [[https://git.fsfe.org/fsfe-system-hackers/accesses|this repository]] to see access reports.
Line 73: Line 126:
=== LDAP team group ===

Remove the former team member of the "team" group in the LDAP database

Log into the LDAP server and run

{{{
ldapvi -D 'cn=admin,dc=fsfe,dc=org' -b 'ou=groups,dc=fsfe,dc=org'
}}}

Look for the "team" entry and remove the person from the "member" attribute
(if the person is also a GA member, do the same for the "ga" entry)

More info about ldapvi at: SVN:/sysadmin/Documentation/Services/LDAP/ldap_admin.txt

=== Git repository ===

For GA members, remove the person from the
[[https://git.fsfe.org/org/fsfe-ga/teams/members|ga group]].

=== Server access and other servies ===

Go to [[https://git.fsfe.org/fsfe-system-hackers/accesses|this repository]] (or ask someone to do it for you) and check if the
leaving person has any remaining access.

=== SVN repositories ===

Remove the member from the "fsfe-team" list in the file
auer:/etc/apache2/svn/svnaccess.

=== Jabber: access to chitchat ===

Remove the jabberid from the access list of the chitchat room
(can be done via jabber client)

=== Wiki: access to internal pages ===

Remove the new member from the wiki page https://wiki.fsfe.org/TeamGroup
Also, when people are leaving the organization, they sometime want to keep
working for FSFE as volunteers. Please ask the person if he / she wants to keep
some user account to keep doing things as a volunteer.

Processes for joining or leaving team members

Admin tasks to do when someone joins or leaves the FSFE. This can be volunteer core team members, interns, staff, or GA members.

If the person leaves the FSFE or her employment ends, you have to revert most or all steps.

1. FSFE account

If the person doesn't have an FSFE account yet, ask her to create a new account by becoming supporter or volunteer.

In the latter case, the account has to be manually activated. Ask them to write an email to contact@fsfe.org to make the account managers aware of it. They should then report back to you to allow you to execute the next steps.

2. Mailing Lists

Add the person to important mailing lists, depending on her position:

Team: team@
Intern/Employee: team@, staff@
System Hackers: system-hackers@
GA: team@, ga@

On the server list1, you can run find_member user@fsfe.org to check a person's membership of possibly sensible mailing lists.

3. LDAP team group

Add the new team member (being in the European core team, an intern or an employee) to the "team" group in the LDAP database

Log into the LDAP server (berzelius) and run

ldapvi -D 'cn=admin,dc=fsfe,dc=org' -b 'ou=groups,dc=fsfe,dc=org'

For each CN, there is a separate section. Add the person to the appropriate sections.

Team: team
Intern/Employee: team, staff
System Hackers: sysadm
GA: team, ga

More info about ldapvi in the syshackers documentation.

4. Access to the wiki internal pages

In order to allow users to access restricted pages, you have to add them to Wiki groups by adding their FSFE accout name in a list. Please note that usernames are case sensitive!

These pages define a group of wiki users that have access to some restricted pages (usually dealing with internal team matters). See this page for further instructions.

Team: Group/Team
Intern/Employee: Group/Team
GA: Group/Team, Group/GA

5. XMPP/Jabber

Employees have to and interested core team members can be member of the chitchat XMPP room.

Room moderators have to add the jabberid to the access list of the room. This can be done via XMPP clients. Please note that the Jabber account has to exist.

Intern/Employee (mandatory): chitchat
Team/GA (optional): chitchat
System Hackers: syshackers

6. OTRS

OTRS is our ticket system. Please add the person to the relevant queues.

Team: depends on individual interests and positions
Intern: Shipping
Employee: depending on work areas
System Hackers: System Administrators
GA: depends on individual interests and positions

Please follow this procedure and this one.

If a person leaves, please make sure to transfer ownership of the remaining open tickets to someone else.

7. Git / Gitea teams

Since some of our files and knowledge resides on git.fsfe.org, new people have to be added to some teams in order to access their repositories. Please note that you can only add users who logged in to Gitea at least once.

Team: FSFE/team
Intern/Employee: FSFE/team, FSFE/staff
System Hackers: fsfe-system-hackers/systemhackers
GA: FSFE/team, FSFE-GA/members

8. Wekan

Some groups use Kanboard extensively.

Intern/Employee: Weekly Staff Planning, Retrospective
System Hackers: System Hackers

Please note that when removing a person from a huge board with many (also archived) cards, the process might take quite long. Do not close the board immediately but wait for Wekan going through all cards and removing the person from them.

9. Nextcloud

Some groups use our Nextcloud installation. Most groups are synced with LDAP, so no need for you to do anything here.

10. Passbolt

Select teams have access to our Passbolt installation which is independent of LDAP or other services.

New users can be invited from within the web interface, and afterwards added to their respective fine-grained groups. Removed users can just be deleted altogether.

It might make sense to rotate the preceding HTTP Basic Auth Password once in a while.

11. Welcome message

Send the Welcome Message to the new team member, replacing the FILLME placeholders with proper values.

When someone leaves

Please do the opposite for all the things explained above.

System Hackers coordinators and the FSFE Council can review this repository to see access reports.

Also, when people are leaving the organization, they sometime want to keep working for FSFE as volunteers. Please ask the person if he / she wants to keep some user account to keep doing things as a volunteer.

TechDocs/TechnicalProcesses/NewPeople (last edited 2023-01-16 13:51:47 by tobiasd)