README CAP-XML (Le français suit) ---------------------------------------- ENVIRONMENT CANADA README file about the warnings in Common Alerting Protocol format (CAP) available on our Meteorological Service of Canada's HTTP data server. To read this file online, please go to: http://dd.weatheroffice.gc.ca/alerts/doc/README_CAP.txt Files are produced or distributed by Environment Canada: http://ec.gc.ca/ ------------------------------------------------------- Edition of 2013-08-28 ------------------------------------------------------- In this file: * About * License * Download * File name * Alert Message Reference Locations * Signature * External documentation * Contact Us ###################### ### About ### ###################### This document explains warnings in CAP-XML format; available on the Datamart of Environment Canada under the following URL: http://dd.weatheroffice.gc.ca/alerts/cap/ The overarching README file of the datamart itself can be found here: http://dd.weatheroffice.gc.ca/about_dd_apropos.txt ############################################## ### License ### ############################################## For the terms of use and conditions of data created and owned by Environment Canada, see the general datamart license at: http://dd.weatheroffice.gc.ca/doc/LICENCE_GENERAL.txt ############################################### ### Download ### ############################################### The alert files are available at the following address: http://dd.weatheroffice.gc.ca/alerts/cap/ A history of 1 month is maintained in this directory. ############################################### ### Alert Message Reference Locations ### ############################################### A Standardized package of GIS (Geographical Information System) based forecast location shapefiles, for all the forecast locations used in EC CAP Messages, are available at the following address: http://dd.weather.gc.ca/meteocode/geodata/ Shapefile packages found there are the same Shapefiles that are used in the operational environment where EC warnings are initally generated. The Shapefile packages are versioned in order to track the available packages to the package used in the operational environment at any given time. Beginning with version 5.0.3 of the GIS package, usage dates for the package will be included in the documentation. ############################################### ### File name ### ############################################### The CAP-XML are grouped in a directory tree that is based on the date and the issuing office of the alert. The directories have the following nomenclature alerts/cap/YYYYMMDD/EEEE/hh/ where: * YYYYMMDD: warning transmission day. * EEEE: 4 letters for the issuing office code * hh: warning transmission hour. The filenames have the following nomenclature: T_BBBBNN_C_EEEE_YYYYMMDDhhmmssss.cap where: * T: constant string. Literal specification from WMO-386 manual as a prefix for this file naming convention. * BBBBNN : 4 letters and 2 numbers representing the primary bulletin type for the warning. Ex: WWCN11. * C: constant string. Similarly specified by WMO, as a prefix for CCCC. * EEEE: 4 letters for the issuing office code (CWAO, CWTO, etc.) * YYYYMMDDhhmmssss: warning transmission date/time. Precise to sub-seconds in case there are two files within same header issued in the same second. ############################################### ### Signature ### ############################################### In order to enable users to verify the integrity of alerts in CAP format, each file ends with a signature in XML Signature format: http://www.w3.org/TR/xmldsig-core/ The public key to verify the signature can be found at this address: http://dd.weatheroffice.gc.ca/public-keyring/dd-pubkey.asc The certificate of this public key is here: http://dd.weatheroffice.gc.ca/public-keyring/L1Cchainroot.pem It is possible to check the integrity of a file by using, for example, the xmlsec software: http://www.aleksey.com/xmlsec/ An example of a call for verification would be: xmlsec1 --verify --pubkey-pem dd-pubkey.asc --trusted-pem L1Cchainroot.pem FILE the output in case of success: ------------------------------------------------------------------------ OK SignedInfo References (ok/all): 1/1 Manifests References (ok/all): 0/0 ------------------------------------------------------------------------ in case of failure: ------------------------------------------------------------------------ func=xmlSecOpenSSLEvpDigestVerify:file=digests.c:line=229:obj=sha1:subj=unknown:error=12:invalid data:data and digest do not match FAIL SignedInfo References (ok/all): 0/1 Manifests References (ok/all): 0/0 Error: failed to verify file "FILE" ------------------------------------------------------------------------ ############################################### ### External documentation ### ############################################### The CAP: What, Why and How: http://www.incident.com/cap/what-why-how.html The Canadian Profile of the Common Alerting Protocol (CAP-CP) http://capan.ca/index.php/en/cap-cp/ CAP Cookbook: http://www.incident.com/cookbook/index.php/Main_Page ############################################### ### Contact Us ### ############################################### If you use the data available on the datamart, you are invited to subscribe to the datamart's mailing list in order to be warned of any updates or changes regarding the data available. You can subscribe here: http://lists.cmc.ec.gc.ca/mailman/listinfo/dd_info and once you are registered, please use that list to contact us through: dd_info@lists.ec.gc.ca for any comments or questions ---------------------------------------- ENVIRONNEMENT CANADA Fichier README à propos des avertissements dans le format du Protocol d'alerte commun (PAC) sur le serveur de données HTTP du Service météorologique du Canada. Pour lire ce fichier en ligne, veuillez aller à: http://dd.meteo.gc.ca/alerts/doc/README_bulletins.txt Les fichiers sont produits ou distribués par Environnement Canada: http://ec.gc.ca/ ------------------------------------------------------- Version du 2013-08-28 ------------------------------------------------------- Dans ce fichier: * Description * Licence * Téléchargement * Emplacement des messages d'alertes * Nom de fichier * Signature * Documentation externe * Pour nous joindre ######################## ### Description ### ######################## Ce document explique ce que sont les avertissements météorologiques dans le format du Protocole d'alerte commun distribués sur le datamart d'Environnement Canada à cet URL: http://dd.meteo.gc.ca/alerts/cap/ Le fichier README global pour le datamart peut être trouvé ici: http://dd.meteo.gc.ca/about_dd_apropos.txt ############################################## ### Licence ### ############################################## Pour les conditions d'utilisation pour les bulletins créés par Environnement Canada, veuillez consulter les conditions générales d'utilisation des données du datamart: http://dd.meteo.gc.ca/doc/LICENCE_GENERAL.txt ############################################### ### Téléchargement ### ############################################### Les bulletins sont disponibles à cette adresse: http://dd.meteo.gc.ca/alerts/cap/ Un historique des données de un mois est conservé dans ce répertoire. ############################################### ### Emplacement des messages d'alertes ### ############################################### Un ensemble de fichiers en format Shapefile contenant les informations géographiques des emplacement des prévisions, pour tous les messages en format CAP, peut être trouvé dans ce répertoire: http://dd.meteo.gc.ca/meteocode/geodata/ Les ensembles de fichiers Shapefile a cet endroit sont les mêmes qui sont utilisés dans l'environnement opérationnel où les avertissements d'Environnement Canada sont créés. Les ensembles Shapiles ont des numéros de version afin de suivre l'évolution des emplacements utilisés dans cet environnement. À partir de la version 5.0.3, la date du début de validité de l'ensemble sera incluse dans la documentation. ############################################## ### Noms de fichier ### ############################################## Les fichiers CAP-XML sont regroupés dans une arborescence basée sur la date et le bureau émetteur de l'alerte. Les répertoires suivent la nomenclature suivante: alerts/cap/YYYYMMDD/EEEE/hh/ où: * YYYYMMDD: jour de la transmission de l'avertissement. * EEEE: Code de 4 lettres du bureau émetteur. * hh: heure de transmission de l'avertissement. Les fichiers suivant la nomenclature suivante: T_BBBBNN_C_EEEE_YYYYMMDDhhmmssss.cap où: * T: caractère constant. Spécification litérale du manuel WMO-386 comme préfixe pour un fichier suivant cette convention de nom. * BBBBNN : 4 lettres et 2 chiffres representant le type de bulletin primaire pour cet avertissement. Ex: WWCN11. * C: caractère constant. Spécifié par l'OMM comme préfixe pour CCCC. * EEEE: 4 lettres pour le code du bureau émetteur (CWAO, CWTO, etc.) * YYYYMMDDhhmmssss: date de transmission de l'avertissement. Précise au millième de seconde, pour couvrir les cas où deux fichiers avec la même entête sont émis dans la même seconde. ############################################### ### Signature ### ############################################### Afin de permettre aux usagers de vérifier l'intégrité des fichiers d'alerte en format PAC (Protocol d'alerte commun), chaque fichier contient à la fin une signature numérique en format XML Signature: http://yios.free.fr/w3c/w3.orgTRxmldsig-core.html La clé publique permettant de vérifier la signature du fichier se trouve à cette adresse: http://dd.meteo.gc.ca/public-keyring/dd-pubkey.asc Le certificat de cette clé publique est à cette adresse: http://dd.meteo.gc.ca/public-keyring/L1Cchainroot.pem Il est possible de vérifier l'intégrité du fichier en utilisant, par exemple, le logiciel xmlsec: http://www.aleksey.com/xmlsec/ Un exemple de vérification avec succès serait: xmlsec1 --verify --pubkey-pem dd-pubkey.asc --trusted-pem L1Cchainroot.pem FICHIER qui retourne en cas de succès: ------------------------------------------------------------------------ OK SignedInfo References (ok/all): 1/1 Manifests References (ok/all): 0/0 ------------------------------------------------------------------------ ou en cas d'échec: ------------------------------------------------------------------------ func=xmlSecOpenSSLEvpDigestVerify:file=digests.c:line=229:obj=sha1:subj=unknown:error=12:invalid data:data and digest do not match FAIL SignedInfo References (ok/all): 0/1 Manifests References (ok/all): 0/0 Error: failed to verify file "FICHIER" ------------------------------------------------------------------------ ############################################### ### Documentation externe ### ############################################### The CAP: What, Why and How (anglais): http://www.incident.com/cap/what-why-how.html Profil canadien du Protocole d'alerte commun (PC PAC) http://capan.ca/index.php/fr/cap-cp/ CAP Cookbook (anglais): http://www.incident.com/cookbook/index.php/Main_Page ############################################## ### Pour nous joindre ### ############################################## Si vous utilisez les données disponibles sur le datamart, vous êtes invités à vous inscrire à la liste de diffusion du datamart afin d'être averti de tout changement ou mise à jour sur les données disponibles. Vous pouvez vous inscrire ici http://lists.cmc.ec.gc.ca/mailman/listinfo/dd_info Une fois enregistré, vous pouvez nous contacter à cette adresse pour toute question ou commentaire: dd_info@lists.ec.gc.ca