Bureaucrats, dave_user, Administrators
770
edits
Changes
fix mediawiki category typo
Generally speaking, source code maintained by DAVE Embedded Systems is delivered to customers via restricted-access [https://git-scm.com git] repositories. To access these repositories a public key is required, as described in the following section.
On explicit request, DAVE Embedded Systems also provide https access to its repositories. Please see the https section below for more information.
== Public key access ==
=== RSA key generation ===
Please follow this procedure to generate the RSA ssh key. It is assumed that the host machine is Linux-based (such as [[::Category:DVDK|DVDKs]] and [[Managed_Virtual_Machine_(MVM)|MVMs]]).
* select your username (pick you main corporate e.g. -mail and use it instead of <code>usernamemyname@myhostmycompany.com</code>)in the examples below
* start the host machine and log in into it
* start a shell session (usually with CTRL-ALT-T)
* launch the following command:
<pre>ssh-keygen -t rsa -C "usernamemyname@myhostmycompany.com" -f usernamemyname@myhostmycompany.com</pre>
* this command creates the files <code>~/.ssh/usernamemyname@myhostmycompany.com</code> ('''private key''') and <code>~/.ssh/usernamemyname@myhostmycompany.com.pub</code> ('''public key''')
* edit your <code>~/.ssh/config</code> by adding the following lines:
Hostname git.dave.eu
PreferredAuthentications publickey
IdentityFile ~/.ssh/usernamemyname@myhostmycompany.com
</pre>
{{ImportantMessage|text=Please make sure that <code>~/.ssh/config</code> has the right ownership/access right <pre>chmod 600 ~/.ssh/configchown $USER ~/.ssh/config</pre> Please refer to [https://linux.die.net/man/5/ssh_config ssh_config man page]}} * Send the request for the creation of a new public git account associated to your username, to the following support email address: [mailto:supporthelpdesk@dave.eu supporthelpdesk@dave.eu]. Please indicate in the subject the name of the product and/or the development kit. The technical support team will enable the account and send you a confirmation as soon as possible.
* Once you have the confirm that your account has been enabled, the easier way to check that everything is configured correctly is to run the following command on you development workstation
</pre>
The output will show you not only that you have successfully login into DAVE Embedded Systems' git server but also which repository you can access and with what access rights. In the following example the user have access all [[AXEL ULite and SBC Lynx Embedded Linux Kit (XUELK)|XUELK]] repository in read-only mode:
<pre>
=== Troubleshooting ===
In case of trouble use ssh verbose mode by using <code>-vvv</code> command line switch (<code>ssh -vvv git@git.dave.eu</code>) and send its output text to [mailto:support@dave.eu DAVE Embedded System Systems' support team].
=== Server fingerprint ===
Upon next connection, ssh client will prompt the user to confirm ECDSA signature like it was the first time connecting to the server.
=== Your Identity ===
The first thing you should do when you install git is to set your user name and email address.
This is important because every git commit uses this information, and they are written into your commits:
<pre>
git config --global user.name "Name Surname"
git config --global user.email myname@mycompany.com
</pre>
Please find documentation [https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup here] and [https://www.kernel.org/pub/software/scm/git/docs/git-config.html here] for more information.
== HTTPS access ==
Some organization filter all outgoing Internet communication apart the one using standard HTTP/HTTPS well known ports (TCP 80 and 443). This will prevent also SSH connection (TCP 22) and, thus, will not allow to access DAVEEmbedded Systems's git repositories using the public key authentication method.
To let those organization access git server, we also provide HTTPS connection, using a standard username/password pair.