Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
contribute:dev:get-a-contributor-account [2014/11/25 11:00] – [Generating a SSH key] nickcontribute:dev:get-a-contributor-account [2024/02/24 10:20] (current) – updated outdated information alexxcons
Line 1: Line 1:
 +~~NOTOC~~
 ====== Get a contributor account ====== ====== Get a contributor account ======
  
-===== Who can apply for an account? =====+There are two ways of getting or creating an account on gitlab.xfce.org: 
 +  - Sign in via an allowed external service, e.g. GitHub 
 +  - Apply for an (internal) account
  
-Well basically anybody, but of course it has to be Xfce related. If you want to translate, a GIT account is not needed, you should [[contribute:translate:|read this first]].\\ +===== Sign in via an allowed external service =====
-That said, please only apply for an account only if you think that you will work on Xfce for a somewhat longer time. If you know that you will only work for a couple of weeks and then never again, please consider not applying for an Xfce account but instead continue to put patches in the [[contribute:bugs:|bug tracker]].+
  
-We also value if you show you work or patches before applying, so we have at least a bit of understanding what you're capable of and if the idea fits in the Xfce philosophy.+If you sign in with e.g. GitHub your account will be immediately created and you can browse all repositories that are public or internal, create issues etc. **However, you cannot create or fork projects yet!** 
 +In order to get full access you have to contact an Admin - see "Apply for an account".
  
-The limitations are not there to exclude anyone -- they are there to ensure that the maintenance of accounts remains reasonable. Of course, to be clear: the Xfce sysadmins have the last word about whether or not to create an account for somebody. + 
 +===== Apply for an account ===== 
 + 
 +The easy way to get a contributor account is to contact developers on the [[https://mail.xfce.org/mailman/listinfo/xfce4-dev|xfce4-dev mailing list]] or to ask in the [[https://matrix.to/#/#xfce-dev:matrix.org|Matrix channel #xfce-dev]]. 
 + 
 +----
  
 ===== SSH ===== ===== SSH =====
  
-For a secure connection to push Git commits, the Xfce project uses SSH keys to authorize on the server.+To be able to push to gitlab.xfce.org you need to either use the HTTPS link and enter your credentials for every push or you create an SSH key and [[https://docs.gitlab.com/ee/ssh/#adding-an-ssh-key-to-your-gitlab-account|add it to your user profile]].
  
 ==== Generating a SSH key ==== ==== Generating a SSH key ====
Line 21: Line 29:
  
   ssh-keygen -b 4096 -t rsa   ssh-keygen -b 4096 -t rsa
- 
-<note important>The Xfce servers support the types RSA, DSA and ECDSA. For RSA/DSA use sufficient bits like 2048 or 4096.</note> 
      
 When the command asks for the //passphrase// it is advised to set a relatively simple password. This password is used to unlock the key when you use it. For more information on how to create a pair of SSH keys, please refer to a [[http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen|SSH documentation]] or book. When the command asks for the //passphrase// it is advised to set a relatively simple password. This password is used to unlock the key when you use it. For more information on how to create a pair of SSH keys, please refer to a [[http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen|SSH documentation]] or book.
Line 32: Line 38:
 </note> </note>
  
-Now that you are finished generating your key pair, you will have two files: a private key and a public key. If you have accepted the default filename, they will be respectively $HOME/.ssh/id_dsa and $HOME/.ssh/id_dsa.pub or $HOME/.ssh/id_rsa and $HOME/.ssh/id_rsa.pub, depending on the type of key you have specified.+Now that you are finished generating your key pair, you will have two files: a private key and a public key. If you have accepted the default filename, they will be respectively ''$HOME/.ssh/id_rsa'' and ''$HOME/.ssh/id_rsa.pub'', depending on the type of key you have specified.
  
 The private key **must** remain secret, do not publish it to anyone under any circumstance. The private key **must** remain secret, do not publish it to anyone under any circumstance.
  
-The public key can be published and shall be sent when you are applying for an Xfce GIT account.  +The public key is what you shall upload to gitlab.xfce.org.
- +
-===== Apply for an account ===== +
- +
-Now you are ready to apply for for an Xfce contributor account. When you register, you will need to enter your name and an e-mail address, which has to be your own. Of course, do not forget that this __email address becomes public__ (at least through Git) so you will unfortunately get some spam as a result. +
- +
- +
-  - Send a mail to [[accounts@xfce.org]] containing the following information: +
-    - Your full name +
-    - Permanent email address +
-    - Requested account name ((lowercase letters a-z, the name should also be easily connectable to the full name, try to avoid nick-names)) +
-    - Explanation why you think you should get an account (in English please) +
-  - The sysadmin with reply to the email (this might take a couple of days) +
-  - If the access is approved, attach (do not paste inline!) the public part of your passphrase protected SSH version 2 key pair (usually ''~/.ssh/id_rsa.pub'' or ''~/.ssh/id_dsa.pub''). Only attach one key, you can add more keys later [[contribute:dev:git:start#adding_and_removing_private_keys|yourself]]. +
  
 +==== Setting up the SSH key so Git uses it ====
  
 +In ''~/.ssh/config'', add:
  
 +  host gitlab.xfce.org
 +    HostName gitlab.xfce.org
 +    IdentityFile ~/.ssh/id_rsa
  
 +[[|Back to Top]]
 +----
 +[[:contribute:dev:start:|Back to main Xfce Development Information page]]