README
¶
go-fasc
FASC, or the Federal Agency Smartcard Number is a legacy specification that stores physical security information that's encoded into smartcards. Internally, this is stored as a 5-bit-byte packed into 8 bit bytes. This library unpacks the bytestream unto an idiomatic struct, to be further handled by the user.
This spec is nearly completely undocumented, and woefully hard to understand. In so far as it's used within the federal government, some serious work needs to be done in order to properly store and process data. This library requires an in-depth understanding of FASC's quirks and internal representation.
Documentation
¶
Index ¶
Constants ¶
View Source
const ( OrganizationalCategoryFederalGoverment OrganizationalCategory = 1 OrganizationalCategoryStateGovernment OrganizationalCategory = 2 OrganizationalCategoryCommercialEnterprise OrganizationalCategory = 3 OrganizationalCategoryForeignGovernment OrganizationalCategory = 4 AssociationCategoryEmployee AssociationCategory = 1 AssociationCategoryCivil AssociationCategory = 2 AssociationCategoryExecutiveStaff AssociationCategory = 3 AssociationCategoryUniformedServivce AssociationCategory = 4 AssociationCategoryContractor AssociationCategory = 5 AssociationCategoryAffiliate AssociationCategory = 6 AssociationCategoryBeneficiary AssociationCategory = 7 )
Variables ¶
View Source
var (
FIPS95_2AgencyCodes = map[int]string{
0300: "LIBRARY OF CONGRESS",
0500: "GOVERNMENT ACCOUNTABILITY OFFICE",
1027: "ADMINISTRATIVE OFFICE OF THE U.S. COURTS",
1100: "EXECUTIVE OFFICE OF THE PRESIDENT",
1145: "PEACE CORPS",
1153: "UNITED STATES TRADE AND DEVELOPMENT AGENCY",
1200: "AGRICULTURE, DEPARTMENT OF",
1300: "COMMERCE, DEPARTMENT OF",
1400: "INTERIOR, DEPARTMENT OF THE",
1500: "JUSTICE, DEPARTMENT OF",
1600: "LABOR, DEPARTMENT OF",
1665: "PENSION BENEFIT GUARANTY CORPORATION",
1800: "POSTAL SERVICE",
1900: "STATE, DEPARTMENT OF",
2000: "TREASURY, DEPARTMENT OF THE",
2300: "U.S. TAX COURT",
2400: "OFFICE OF PERSONNEL MANAGEMENT",
2700: "FEDERAL COMMUNICATIONS COMMISSION",
2800: "SOCIAL SECURITY ADMINISTRATION",
2900: "FEDERAL TRADE COMMISSION",
3100: "NUCLEAR REGULATORY COMMISSION",
3300: "SMITHSONIAN INSTITUTION",
3352: "J. F. KENNEDY CENTER FOR THE PERFORMING ARTS",
3355: "NATIONAL GALLERY OF ART",
3400: "INTERNATIONAL TRADE COMMISSION",
3600: "VETERANS AFFAIRS, DEPARTMENT OF",
4100: "MERIT SYSTEMS PROTECTION BOARD",
4500: "EQUAL EMPLOYMENT OPPORTUNITY COMMISSION",
4602: "APPALACHIAN REGIONAL COMMISSION",
4700: "GENERAL SERVICES ADMINISTRATION",
4900: "NATIONAL SCIENCE FOUNDATION",
5000: "SECURITIES AND EXCHANGE COMMISSION",
5300: "THE INSTITUE OF MUSEUM AND LIBRARY SERVICES",
5400: "FEDERAL LABOR RELATIONS AUTHORITY",
5920: "NATIONAL ENDOWMENT FOR THE ARTS",
5940: "NATIONAL ENDOWMENT FOR THE HUMANITIES",
6000: "RAILROAD RETIREMENT BOARD",
6100: "CONSUMER PRODUCT SAFETY COMMISSION",
6201: "OFFICE OF SPECIAL COUNSEL",
6300: "NATIONAL LABOR RELATIONS BOARD",
6500: "FEDERAL MARITIME COMMISSION",
6800: "ENVIRONMENTAL PROTECTION AGENCY",
6900: "TRANSPORTATION, DEPARTMENT OF",
7000: "HOMELAND SECURITY, DEPARTMENT OF",
7100: "OVERSEAS PRIVATE INVESTMENT CORPORATION",
7200: "AGENCY FOR INTERNATIONAL DEVELOPMENT",
7300: "SMALL BUSINESS ADMINISTRATION",
7400: "AMERICAN BATTLE MONUMENTS COMMISSION",
7500: "HEALTH AND HUMAN SERVICES, DEPARTMENT OF",
8000: "NATIONAL AERONAUTICS AND SPACE ADMINISTRATION",
8300: "EXPORT-IMPORT BANK OF THE U.S.",
8600: "HOUSING AND URBAN DEVELOPMENT, DEPARTMENT OF",
8800: "NATIONAL ARCHIVES AND RECORDS ADMINISTRATION",
8900: "ENERGY, DEPARTMENT OF",
9000: "SELECTIVE SERVICE SYSTEM",
9100: "EDUCATION, DEPARTMENT OF",
9300: "FEDERAL MEDIATION AND CONCILIATION SERVICE",
9502: "NATIONAL CAPITAL PLANNING COMMISSION",
9504: "FEDERAL MINE SAFETY AND HEALTH REVIEW COMMISSION",
9505: "SURFACE TRANSPORTATION BOARD",
9506: "FEDERAL ELECTION COMMISSION",
9507: "COMMODITY FUTURES TRADING COMMISSION",
9508: "NATIONAL TRANSPORTATION SAFETY BOARD",
9511: "THE COUNCIL OF THE INSPECTORS GENERAL ON INTEGRITY AND EFFICIENCY ",
9513: "MARINE MAMMAL COMMISSION",
9514: "OCCUPATIONAL SAFETY AND HEALTH REVIEW COMMISSION",
9515: "ADMINISTRATIVE CONFERENCE OF THE U. S.",
9516: "DEFENSE NUCLEAR FACILITIES SAFETY BOARD",
9518: "COMMITTEE FOR PURCHASE FROM PEOPLE WHO ARE BLIND OR SEVERELY DISABLED",
9523: "ELECTION ASSISTANCE COMMISSION",
9524: "NATIONAL MEDIATION BOARD",
9526: "PRIVACY AND CIVIL LIBERTIES OVERSIGHT BOARD",
9532: "ARCHITECTURAL AND TRANSPORTATION BARRIERS COMPLIANCE BOARD",
9533: "GULF COAST ECOSYSTEM RESTORATION COUNCIL",
9536: "VIETNAM EDUCATION FOUNDATION",
9537: "COMMISSION OF FINE ARTS",
9542: "FEDERAL HOUSING FINANCE AGENCY",
9543: "MILLENIUM CHALLENGE CORPORATION",
9545: "MORRIS K. UDALL SCHOLARSHIP AND EXCELLENCE IN NATIONAL ENVIRONMENTAL POLICY FOUNDATION",
9549: "OFFICE OF GOVERNMENT ETHICS",
9557: "NORTHERN BORDER REGIONAL COMMISSION",
9565: "CHEMICAL SAFETY AND HAZARD INVESTIGATION BOARD",
9568: "UNITED STATES AGENCY FOR GLOBAL MEDIA, BBG",
9572: "DENALI COMMISSION",
9577: "CORPORATION FOR NATIONAL AND COMMUNITY SERVICE",
9594: "COURT SERVICES AND OFFENDER SUPERVISION AGENCY",
9700: "DEPT OF DEFENSE",
5700: "DEPT OF AIR FORCE",
1700: "DEPT OF NAVY",
}
)
Functions ¶
This section is empty.
Types ¶
type AgencyCode ¶
type AgencyCode int
func (AgencyCode) String ¶
func (o AgencyCode) String() string
type AssociationCategory ¶
type AssociationCategory int
func (AssociationCategory) String ¶
func (ac AssociationCategory) String() string
type FASC ¶
type FASC struct {
// Agency Code identifies what Government agnecy issued the credential.
// This is usually a FIPS 95-2 federal agency code. An incomplete table
// of these values is provided in this library, but this type is just a
// retyped Int, direct access of the underlying value is encouraged.
AgencyCode AgencyCode
// Identifies the system the card is enrolled in.
SystemCode int
// Unique for the given system. This plus the system and agency code should
// be a unique identifier for this token.
Credential int
// Major version changes in the data above.
CredentialSeries int
// Individual incrementing counter for the number of times a card has been
// replaced due to loss or damage.
IndidvidualCredentialSeries int
// Unique identifier for an individual. This is sometimes a fairly low
// incrementing identifier for the ACL system, and other times it's an
// agency-wide globally unique identifier such as an EDIPI.
PersonIdentifier int
// Type of orgnaization that the cardholder belongs to.
//
// A table of values is provided in this library, but this is a masked
// integer in the event you need direct access. It's likely easier to
// set up a switch statement using the defined constants on this, though.
//
// Valid values here are:
//
// - Federal Government Agency
// - State Government Agency
// - Commercial Enterprise
// - Foreign Government
//
OrganizationCategory OrganizationalCategory
// For the particular category above, this is an iditifier to determine
// which agency, state, company or government this cardholder is a part
// of.
//
// Given a Federal Government Agency, this will be a FIPS 95-2 agency code.
// Given a State Government Agency, this will be a State Code.
// Given a Commercial Enterprise, this will be a Company Code
// Given a Foreign Government, this will be a Country Code.
OrganizationIdentifier AgencyCode
// What the relation of this person to the above organization is.
//
// This is a masked int, and direct access to the underlying value may
// be helpful, but it may be more helpful to use the defined constants.
//
// Valid values here are:
//
// - Employee
// - Civil
// - Executive Staff
// - Uniformed Service
// - Contractor
// - Organizational Affiliate
// - Organizational Beneficiary
//
PersonAssociation AssociationCategory
}
type OrganizationalCategory ¶
type OrganizationalCategory int
func (OrganizationalCategory) String ¶
func (oc OrganizationalCategory) String() string
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.