Editing Test Day:2013-03-28 Shared System Certificates

{{Infobox_group
| name = Fedora Test Days
| image = [[File:Echo-testing-48px.png|link=QA/Fedora_19_test_days]]
| caption = Shared System Certificates
| date = 2012-03-28
| time = all day
| website = [[QA/Fedora_19_test_days]]
| irc = [irc://irc.freenode.net/#fedora-test-day #fedora-test-day] ([http://webchat.freenode.net/?channels=fedora-test-day webirc])
| fedora_mailing_list = test
}}

{{admon/note | Can't make the date? | If you come to this page before or after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find at [http://bugzilla.redhat.com Bugzilla], and add your results to the results section. If this page is more than a month old when you arrive here, please check the [[QA/Test_Days|current schedule]] and see if a similar but more recent Test Day is planned or has already happened.}}

== What to test? ==

Today's instalment of Fedora Test Day will focus on testing the [[Features/SharedSystemCertificates|Shared System Certificates]] feature. The goal is to make NSS, GnuTLS, OpenSSL and Java share a default source for retrieving system certificate anchors and black list information. 

The work done in Fedora 19 is an initial step of a comprehensive solution. But none the less it makes the installation of anchors and blacklists standardized across the various crypto libraries. Currently an ''update-ca-trust'' step is required, but in the future we hope to make this unnecessary.

== Who's available ==

The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...
* Development - [[User:Stefw|Stef Walter]] (stefw), [[User:KaiEngert|Kai Engert]] (kaie)
* Quality Assurance - [[User:JiriJaburek|Jiri Jaburek]] (jjaburek), [[User:AlesMarecek|Ales Marecek]] (alich)

== Prerequisite for Test Day == 

To test this feature you need an updated Fedora 19 system, with at least the following software:

* p11-kit 0.17.4 (or later)
* p11-kit-trust 0.17.4 (or later)
* ca-certficates 2012.87-9.fc19.1 (or later)
* nss 3.14.3-10 (or later)

See the detailed [[Test_Day:2013-03-28_Shared_System_Certificates/Prerequisites|prerequisites page]] to get yourself setup for the test cases below.

TODO: There will be a live image available for testing.

== How to test? ==

You can use the test cases below, or you can explore the feature further. At a high level the following are being tested

* '''p11-kit-trust''' provides a replacement for the NSS ''libnssckbi.so'' module. The ''libnssckbi.so'' used to provide built in certificate trust anchors and blacklists, and now the ''p11-kit-trust.so'' module does this. So we'll be testing that NSS applications (like Firefox) continue to work as expected.

* '''ca-certificates''' extracts files ready for ''p11-kit-trust.so'' to use. We'll be testing that these files are installed correctly to be picked up.

* '''ca-certificates''' provides an ''update-ca-trust'' script which uses '''p11-kit''' to extract certificate anchor information from ''p11-kit-trust.so'' for crypto libraries (gnutls, openssl, java) that cannot yet read directly from ''p11-kit-trust.so'' on the fly. We'll test this extract process, and make sure that applications using these crypto libraries continue to work as expected.

* There is now a standard method for adding a certificate anchor. We'll test that this works, and is picked up by all the applications.

The test cases below explore the above actions and more. You of course are free to go out of bounds and provide additional testing and feedback. Below is some documentation you may find useful as you do:

* http://p11-glue.freedesktop.org/doc/p11-kit/trust.html
* http://p11-glue.freedesktop.org/trust-module.html

For each bug you find report a bug on [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora Red Hat Bugzilla] under the Fedora product, and the relevant component.

=== '''Update your machine''' ===

If you're running Fedora 19, make sure you have all the above packages updated. This feature is not testable on Fedora 18 or Rawhide at the current time. Alternatively:

=== '''Live image''' ===

Optionally, you may download a non-destructive Fedora 19 live image for your architecture.

Download the [http://dl.fedoraproject.org/pub/alt/stage/19-Alpha-TC2/ recommended live image] for this test day. General tips on using a live image are available at [[FedoraLiveCD]].

== Test Cases ==

These are in a recommended order, although you may skip around. Each test case notes its prerequisites and setup.

<!-- If you change the order here, update the numbers in the table below -->
# [[QA:Testcase_Certificate_Trust:Untrusted_Certificate|Reject untrusted certificates]]
# [[QA:Testcase_Certificate_Trust:System_Trust|Validate system trusted certificates]]
# [[QA:Testcase_Certificate_Trust:Configure_Anchor|Configure a new certificate authority anchor]]
# [[QA:Testcase_Certificate_Trust:Deconfigure_Anchor|Remove a configured certificate authority anchor]]
# [[QA:Testcase_Certificate_Trust:Blacklist_Root|Blacklist a root certificate authority]]
# [[QA:Testcase_Certificate_Trust:Blacklist_Intermediate|Blacklist an intermediate certificate authority]]
# [[QA:Testcase_Certificate_Trust:Edit_Trust_In_Firefox|Edit trust in Firefox]]
# (incomplete) [[QA:Testcase_Certificate_Trust:Upgrade_Bundle|Upgrade to Fedora 19 with a modified CA bundle]]

== Test Results ==

If you have problems with any of the tests, report a bug to [https://bugzilla.redhat.com Bugzilla] usually for the component [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=19&component=ca-certificates ca-certificates], or [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=19&component=p11-kit p11-kit]. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you.

Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one. For each test case, use the [[Template:result|result template]] to enter your result, as shown in the example result line.

{|
! User
! [[QA:Testcase_Certificate_Trust:Untrusted_Certificate|1. untrusted]]
! [[QA:Testcase_Certificate_Trust:System_Trust|2. systrust]]
! [[QA:Testcase_Certificate_Trust:Configure_Anchor|3. configure]]
! [[QA:Testcase_Certificate_Trust:Deconfigure_Anchor|4. deconfig]]
! [[QA:Testcase_Certificate_Trust:Blacklist_Root|5. badroot]]
! [[QA:Testcase_Certificate_Trust:Blacklist_Intermediate|6. badinter]]
! [[QA:Testcase_Certificate_Trust:Upgrade_Bundle|7. upgrade]]
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|none}} 
| {{result|pass}}
| {{result|warn}} <ref>Test pass, but also encountered {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| {{result|none}}
| {{result|none}}
| {{result|none}}
| <references/>
|-
|}

[[Category:Test Days]]