2. SmartHR-Bibliothek kiji wird verwendet, um e-Gov (öffentliche Materialien von e-Gov) auszuführen

Einführung in den Ablauf und die öffentlichen Materialien für allgemeine Softwareentwickler zur Entwicklung von Softwarediensten mithilfe der externen Verknüpfungs-API von e-Gov.

1. 1. Entwicklungsfluss

Allgemeine Softwareentwickler usw. (im Folgenden als Entwicklungsunternehmen bezeichnet) müssen die Softwareentwicklung bei e-Gov (Ministerium für innere Angelegenheiten und Kommunikation) beantragen.

① Beantragen Sie die Softwareentwicklung ② Dokumente im Zusammenhang mit dem Antrag auf Verwendung der Verifizierungsumgebung werden von e-Gov gesendet ③ Der Entwickler füllt die erforderlichen Elemente (Benutzer-ID usw.) aus und sendet die Anwendungsanwendung für die Verifizierungsumgebung an e-Gov. ④ e-Gov sendet Materialien zur Verifizierungsumgebung ⑤ Entwickler entwickelt Software-Service ⑥ Der Entwickler beantragt den endgültigen Bestätigungstest ⑦ Der Entwickler übermittelt das endgültige Bestätigungstestergebnis ⑧ Der Softwaredienst wird durch ein Urteil von e-Gov verfügbar

In ③ beschreibt der Entwickler die folgenden Inhalte im Anwendungsformular für die Verifizierungsumgebung.

Bei ④ sendet Ihnen e-Gov Materialien zur Verifizierungsumgebung. Entwickler müssen diese Informationen streng kontrollieren.

Die URL der Überprüfungsumgebung ist eine andere Anforderungs-URL als die Produktionsumgebung. Zu diesem Zeitpunkt wird die in der Anwendungsanwendung für die Verifizierungsumgebung beschriebene Benutzer-ID in e-Gov registriert, und die folgenden Zertifikate werden in Verbindung mit dieser Benutzer-ID verwaltet.

2. Über öffentliche Materialien

Sie können die für Entwickler von e-Gov vorbereiteten Materialien herunterladen. Hier finden Sie Gebrauchsanweisungen, Begriffe, Antragsformulare, Spezifikationen, elektronische Zertifikate zum Testen der Verifizierungsumgebung usw.

Hier werden die Spezifikationen, Testverfahren für die Verifizierungsumgebung und elektronische Zertifikate vorgestellt.

2.1 Technische Daten

(1) API-Spezifikationen (Version 1)

Beschreibt die Spezifikationen für den Anforderungs-URI und seine Parameter für die Erstellung einer elektronischen Anwendung unter Verwendung der API, das im http-Anforderungshauptteil angegebene Übertragungs-XML und den von e-Gov zurückgegebenen Antworttext (Antwort-XML).

(2) Spezifikationen für Informationssicherheitsanforderungen

Es beschreibt die Sicherheitsanforderungen, die Entwickler bei der Entwicklung von Software erfüllen müssen.

(3) Anwendungsdatenspezifikationen Gemeinsame Datenspezifikationen

Die allen Verfahren gemeinsamen Datenspezifikationen und die individuellen Spezifikationen für jedes Verfahren werden beschrieben. XML-Tag-Strukturen werden für Konfigurationsmanagement-XML, Konfigurationsinformations-XML und Anwendungs-XML definiert.

(4) Anwendungsdatenspezifikationen und Definition der Anwendungs-XML-Struktur

Individuelle Spezifikationen bezüglich der Anwendungsdaten für jedes Verfahren werden beschrieben.

2.2 Testverfahren für die Überprüfungsumgebung

Dies ist eine öffentliche Spezifikation bezüglich des Testverfahrens, das beim Testen in Bezug auf die externe Verknüpfungs-API in der Verifizierungsumgebung verwendet werden kann.

• In der Überprüfungsumgebung werden 38 Arten von Standardformaten und 45 Arten von individuellen Signaturformaten für arbeits- und sozialversicherungsbezogene Verfahren sowohl für normale als auch für Fehlersysteme vorbereitet. --Jedes Verfahren definiert Bedingungen im Zusammenhang mit dem Verfahren (ob unterschrieben, beigefügte Dokumente, Einreichungsziel, Widerruf usw.), mögliche Verarbeitung nach der Ankunft usw.
• Jede Prozedur gehört zu einem von 32 Formularmustern, und es ist erforderlich, Datenelemente entsprechend dem Inhalt des Formularmusters festzulegen.

In der "Liste der API-Testverfahren" können Sie den folgenden Inhalt für das Testverfahren überprüfen.

――Das Antragsformular für jedes Verfahren ist so strukturiert, dass es die Testfälle abdeckt, die für Tests im Zusammenhang mit der API erforderlich sind, und die entsprechenden Verfahrensinformationen werden festgelegt und verwaltet.

• Für die Verfahren zur Ausstellung offizieller Dokumente und die Verfahren zur Benachrichtigung von Kommentaren werden Musterdokumente und Kommentarinhalte benachrichtigt.
• Die für Anhänge zulässigen Dateiformaterweiterungen sind "doc", "xls", "pdf", "docx", "xlsx" und "txt".
• Bei Prozeduren, deren erste drei Ziffern der Prozedurkennung "950" sind, wird der Status nach der Anwendung automatisch geändert.

In der Liste "API-Testverfahren (angehängte Statusübergangsliste für API-Testverfahren)" können Sie den automatischen Statusübergang überprüfen. Die folgenden zwei Beispiele werden vorgestellt.

• Im Standardformat lautet der Name des Verfahrens für die Verfahrenskennung = 950A010002010000 "Benachrichtigung über Änderungen (Korrekturen) im Zusammenhang mit der Gründung einer Krankenversicherung / einer Sozialrentenversicherung / einem elektronischen Antrag", und es wird ein offizielles Dokument ausgestellt. Wenn der Softwaredienst eine Stapelanwendung erstellt, wechselt er automatisch von (erreicht) → (überprüft) → (abgeschlossene Überprüfung), und wenn er erreicht (abgeschlossene Überprüfung), kann das offizielle Dokument abgerufen werden.
• Im Standardformat ist die Verfahrenskennung = 950A010700007000 der Verfahrensname "Krankenversicherungs- / Sozialrentenversicherung, Benachrichtigung über den Erwerb einer versicherten Qualifikation, Seefahrerversicherung / Sozialrentenversicherung, Benachrichtigung über den Erwerb einer qualifizierten Qualifikation / elektronischer Antrag" und ein offizielles Dokument. Wird nicht ausgestellt. Wenn der Softwaredienst eine Stapelanwendung erstellt, wechselt er automatisch von (erreicht) zu (überprüft). Wenn der Softwaredienst eine Auszahlungsanforderung durch Angabe der Ankunftsnummer stellt, wechselt er automatisch von (während der Überprüfung der Auszahlungsverarbeitung) → (Verfahren abgeschlossen - zurückgezogen).

2.3 Elektronisches Zertifikat

In diesem Abschnitt wird die SHA-256-Version des in der Überprüfungsumgebung verwendeten digitalen Zertifikats beschrieben.

Das digitale Zertifikatsuffix repräsentiert das Format des Zertifikats. ".Pfx" ist ein PKCS # 12 (PFX) -Format für Schlüssel und Zertifikate, mit dem der Serverschlüssel zusammen mit der gesamten Zertifikatkette gespeichert und geschützt werden kann. Dieses Format wird häufig in Microsoft-Produkten verwendet.

Überprüfen Sie den Inhalt des Zertifikats mit dem Befehl openssl. Wenn Sie unterwegs nach einem Passwort gefragt werden, geben Sie "gpkitest" ein.

Ausführungsergebnis von openssl

>openssl pkcs12 -info -in e-GovEE01_sha2.pfx
Enter Import Password:(Geben Sie "gpkitest" ein)
MAC Iteration 2000
MAC verified OK
PKCS7 Data
Shrouded Keybag: pbeWithSHA1And3-KeyTripleDES-CBC, Iteration 2000
Bag Attributes
    localKeyID: 01 00 00 00
    friendlyName: le-d39d0281-d8cb-4396-b002-b4366119c8e4
    Microsoft CSP Name: Microsoft Enhanced Cryptographic Provider v1.0
Key Attributes
    X509v3 Key Usage: 10
Enter PEM pass phrase:
Verifying - Enter PEM pass phrase:
-----BEGIN ENCRYPTED PRIVATE KEY-----
MIIFDjBABgkqhkiG9w0BBQ0wMzAbBgkqhkiG9w0BBQwwDgQITLitdILmV8cCAggA
MBQGCCqGSIb3DQMHBAiXSoB8We54iwSCBMiWf80URxShHlnQltb0fsWst7cAZF2D
/FnXM/8RRrMuK561dB5f+7ImMTtJobdOYOEpeO8sqxhGGeEnivFPMhvrsdGKMZul
nCoQBk0ug0iG2vnlQZAP6RPhbo9u4H3ZtTxJeO4DnYdJJj681vxlkEwhQ+Xv7arV
ZkDAmP20E3tKsobuIKNoLDF6HvrsW6k3bSeYcQqjm71BUAZe9DR2JnBNilbnN7gn
NXtsl8B2bGj8/bATsF37elW/zRkm+35vhcV4jLOEJY67ZF9uVAmSgjGXDuEo3pWO
jrX3t5ErsDXXObjw35cVVTvXUZl6s98p2QC3D/hThUf+MBE+pjO3AnNdb0Pjikmf
Fx1VSaeRW1vpf6/oOdwBUGPJuUXyZm1t93/AiYMOG5r9UFLRoFoHKYeCUte+BO2o
N6M2wUSgekzQejrZeT6ATvRpA15yQ6laAFw6LwPRbJ3zykCch2UAPJaspXgUzdfA
9jGzGuq9xIOgeVe+Gi2OdLBk+hAc0qF+zkrwuhswWT3vSSNQ2/mlfl3kI7MPzcvB
82mzC0aPCts8oG0JVL3m/WpnfO6XFnB5GRB10mo7NyiecjHOEPCfsjOcsTr/Bl1N
EPkh4Rt+o315l4UFtIw8nfK8xiw9ag6Lc8n3IUy9+fUWe/MmZxsvKfMyUe8x8RJA
gubv1R8RUqPg+rq6rCydlPE3RlMwro5ooF5sblWANPpNJwyTOr1CEJHTyWzzdMnz
pdbVj0Tz9P3YvR9+KUmv5FPO+Ke/G0KLVbvg14OUfTr5xFEihUrYPOWtRlGlGOyT
le+rGFAzIsRTJvFU6RGsktGTXyzmPBxY2YPuTnDnkdUCLl8UIcXUPMeWRSIh5YC0
zpPgwLlDdy0dnDSIYo5j2yjhYCYcx0MkkZpkn896RcFkK/QnX5L+EvCz6GIZVxAi
yEzD6lFs4Uamm7E/6MbfyoxxbfIOq8BKoufhSbu/QzUlVw/f1+HXjROaTjB2zRuo
GmuWMugdhEMkKl1R4MTpIhoORdQNYGRWcJfbvSZx6gAmTDMoYkt5h05+haNyXY3t
VkLIlHnpRcQR+JgFghyp0j49kmgyKjRZ6XyCgRnUazE9GOalCZLRZuFQEIlgjNRQ
i5f+LI1UNULxD3PJR8A6AMXiasfk94t4qlpH5xc2HVC44Hrk/gX9vfIYBodw43qX
/r0Z2H/27Qte0IRAZ3jzBV46wN2Y0fqKVQNFchIIJleSebd/ka317ICI8gphf+Js
7Y//jUfl03X7oB2GviVHNzvtjJy0AgAlHkltEgswSbWmd3e+lsCtRpnpe4f1qj76
nYTy0AYtvcZwsE7EaCDYGz/KGQVJjorKVgK12N27catPUcDX3NPMhv9YVe1rcVhT
Iku2X6b0c+YmDSGs05m0LUp8HMN/RUAVg+77atjBT72yqABzV2OcZDc9vHCZfYg2
hO/NSfITPB/Jun/gd4VgjH8sO9Eupa/DgZKQ7b858Md6kjK37iKu8cxvG9VfizFj
/msgnKpZmB0lXnvb7hQUgbeOXC0HP1VswZqq1JBzvFICcFo+4KZQquig2SJytR5o
bFxOWp1zXMllQWSunt1aMnmun/B68BU6SiNXNjnTn+gAd+i3avys8X1VLZBFAwKF
6wY=
-----END ENCRYPTED PRIVATE KEY-----
PKCS7 Encrypted data: pbeWithSHA1And40BitRC2-CBC, Iteration 2000
Certificate bag
Bag Attributes
    localKeyID: 01 00 00 00
subject=/C=JP/O=DemoMin1/OU=CA1/CN=Ichiro Madoguchi
issuer=/C=JP/O=DemoMin1/OU=CA1
-----BEGIN CERTIFICATE-----
MIIEizCCA3OgAwIBAgIEWCsMRzANBgkqhkiG9w0BAQsFADAuMQswCQYDVQQGEwJK
UDERMA8GA1UECgwIRGVtb01pbjExDDAKBgNVBAsMA0NBMTAeFw0xOTEwMjUwMTE2
NTZaFw0yNDEwMjQxNDU5NTlaMEkxCzAJBgNVBAYTAkpQMREwDwYDVQQKDAhEZW1v
TWluMTEMMAoGA1UECwwDQ0ExMRkwFwYDVQQDDBBJY2hpcm8gTWFkb2d1Y2hpMIIB
IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsD81VFFmGM26HYdeGrGzbPba
deBzU4WxIE1r6qeZLxjz7DiV42tjo8QFulWZk6hmCeb5j9ChKp+BA/9Yj6usccKH
ZrPQmbcXUZkXRXz9z/7CLxp8b1zAzJakZ0g7o9iU3a3TpyeP6V+GFtkO8YqfthEs
JsYzx82dUi85Bm4l5pnztozPdXRZd2VJpdwzGqtqw6N9PKzMNWux5C0jklkaPeP5
P6NHLfeN51+phkY2xkdJlry629PeKjZAwN0Z8Xu0JdubCvA95UctoZgBoOjpgDtW
ImV3o9hDpwu+1tMlEBhNZIuKOr2G38qRZ9iJUyoK+XhbzyBUu0A2cwCj0MshbwID
AQABo4IBlDCCAZAwDgYDVR0PAQH/BAQDAgbAMBEGCWCGSAGG+EIBAQQEAwIGQDBO
BgNVHRIERzBFpEMwQTELMAkGA1UEBhMCSlAxHjAcBgNVBAoMFeaooeaTrOawkemW
k+iqjeiovOWxgDESMBAGA1UECwwJ77yj77yh77yRMB8GA1UdIAEB/wQVMBMwEQYP
AoM4ho4xCAEBAAKMmyVkMGgGA1UdEQRhMF+kXTBbMQswCQYDVQQGEwJKUDEeMBwG
A1UECgwV5qih5pOs5rCR6ZaT6KqN6Ki85bGAMRIwEAYDVQQLDAnvvKPvvKHvvJEx
GDAWBgNVBAMMD+eqk+WPo+OAgOS4gOmDjjBQBgNVHR8ESTBHMEWgQ6BBpD8wPTEL
MAkGA1UEBhMCSlAxETAPBgNVBAoMCERlbW9NaW4xMQwwCgYDVQQLDANDQTExDTAL
BgNVBAMMBENSTDEwHwYDVR0jBBgwFoAUFNPnlvRSx8XFOnRlLumW95h4I18wHQYD
VR0OBBYEFD6UH9Exye9dEpz9MHJ3sbUDpoZSMA0GCSqGSIb3DQEBCwUAA4IBAQBb
CKyFGsqMv6+HkrY0OK+4v40PJQAa/KbOC3JTKooLfNCNXTiTwtWAl1sGN+Ow8pIp
8Yvj16VcYpi8zO4TmNe8NT+u/e2OvBXwJ9OxOs9UNI2m/mXGcSSJ7eXMR3aVCniD
U7IaQeicquQttLP9IOk9Ao1W+BM35y5bITA/BMO5tzgaimp4G484QtF/XLi40rGh
aZAHGEfvl0abJXPumjajhnGv7SCkjw4+9qdz5Dtp6kl+GVshQgo6ofpEWhVzdhfq
KhNy8dNRL7C/gOTYm+M9SAFk9syL5xKXRyMUGDOheypiJrW/QyOjrxs6cFa5VqaZ
WcRIq8yVPwABCpGG/hjU
-----END CERTIFICATE-----

――Der Teil, der von "----- BEGIN ENCRYPTED PRIVATE KEY -----" bis "----- END ENCRYPTED PRIVATE KEY -----" eingeschlossen ist, ist der private Schlüssel. --Der Teil, der von "----- BEGIN CERTIFICATE -----" bis "----- END CERTIFICATE -----" umgeben ist, ist das Zertifikat (öffentlicher Schlüssel).

• Subjekt bedeutet die zu beweisende Person, und Emittent bezeichnet die zu beweisende Person. --subject = / C = JP / O = DemoMin1 / OU = CA1 / CN = Ichiro Madoguchi, Aussteller = / C = JP / O = DemoMin1 / OU = CA1, das ein selbstsigniertes Zertifikat zum Testen ist, also der Aussteller ( Der Emittent) und das Subjekt sind dieselbe Organisation.

In e-Gov verwaltet der Softwareentwickler drei Zertifikate, indem er sie mit der Benutzer-ID verknüpft, die bei der Beantragung der Verifizierungsumgebung gewünscht wird. Beim Testen werden normalerweise gültige Zertifikate verwendet. Darüber hinaus werden das abgelaufene Zertifikat und das widerrufene Zertifikat im Test verwendet, um das von e-Gov verwaltete Zertifikat zu erneuern.

3. 3. Über den endgültigen Bestätigungstest

Vergewissern Sie sich für den endgültigen Bestätigungstest, dass das Senden / Empfangen von Daten zwischen dem Softwaredienst und e-Gov gemäß den e-Gov-Spezifikationen erfolgreich ist. Die Funktion des Softwaredienstes als Anwendung wird nicht bestätigt.

Die SmartHR-Bibliothek kiji verwendet RSpec, um den endgültigen Bestätigungstest zu automatisieren.