Object Attributes

Object Attributes

1 Object Attributes | 1.1 address | 1.2 admin-c | 1.3 aggr-bndry | 1.4 aggr-mtd | 1.5 alias | 1.6 as-name | 1.7 auth | 1.8 certif | 1.9 changed | 1.10 components | 1.11 default | 1.12 descr | 1.13 e-mail | 1.14 export | 1.15 export-comps | 1.16 fax-no | 1.17 filter | 1.18 fingerpr | 1.19 geoidx | 1.20 holes | 1.21 ifaddr | 1.22 import | 1.23 inject | 1.24 local-as | 1.25 member-of | 1.26 members | 1.27 mnt-by | 1.28 mnt-nfy | 1.29 method | 1.30 nic-hdl | 1.31 notify | 1.32 origin | 1.33 owner | 1.34 peer | 1.35 phone | 1.36 remarks | 1.37 source | 1.38 tech-c | 1.39 trouble | 1.40 upd-to

Below is a list of the various types of object attributes that can be used with RADb Objects

Object Attributes

If you are unsure about which attributes are optional and which are mandatory for a RADb Object, you can use a WHOIS query against RADb WHOIS to list the attributes. The query flag is -t <object> where <object> is one of route, route6, etc.

Example:

$ whois -h whois.radb.net -- -t route route: [mandatory] [single] [primary/look-up key] descr: [optional] [multiple] [] origin: [mandatory] [single] [primary key] holes: [optional] [multiple] [] member-of: [optional] [multiple] [look-up key, weak references route-set] inject: [optional] [multiple] [] aggr-bndry: [optional] [single] [] aggr-mtd: [optional] [single] [] export-comps: [optional] [single] [] components: [optional] [single] [] admin-c: [optional] [multiple] [look-up key, strong references role/person] tech-c: [optional] [multiple] [look-up key, strong references role/person] geoidx: [optional] [multiple] [] roa-uri: [optional] [single] [] remarks: [optional] [multiple] [] notify: [optional] [multiple] [] mnt-by: [mandatory] [multiple] [look-up key, strong references mntner] changed: [optional] [multiple] [] source: [mandatory] [single] []

address

The postal address of a person or role in the RADB.

admin-c

The administrative contact for the object. Can be a person's name or a NIC handle.

Note:

  • You can only use admin-c and tech-c if the NIC handle you reference already exists in a person or role object in RADb.

  • If the NIC handle doesn’t match, the object won’t be accepted.

  • RADb also shows the linked contact information when someone views your record.

aggr-bndry

Defines the set of Autonomous Systems (ASes) that form a boundary for route aggregation.
If not specified, only the origin AS acts as the boundary. Within the boundary, more specific routes are shared. Outside the boundary, only the aggregate route is shared.

aggr-mtd: inbound | outbound [<as-expression>]

aggr-mtd

Specifies how an aggregate route is created. Can be either "inbound" (routes are combined when received) or "outbound" (routes are combined before sending).

alias

An optional attribute for routers that specifies the canonical DNS name of the router.

as-name

A descriptive name for an Autonomous System (AS), consisting of uppercase letters, numbers, and dashes. Must start with a letter and not include spaces.

auth

Indicates the authentication method for updating RADB objects. Commonly uses BCRYPT-PW, which stores a hashed version of the maintainer’s password.

certif

Contains the public key certificate in a secure, encoded format. Used for verifying the authenticity of a maintainer.

changed

Specifies who last updated the object and the date of the update.
Format:

changed: <email address> <YYYYMMDD>

components

Lists the individual routes that make up an aggregated route.

default

Specifies default routing policies when a router lacks a more specific route. Defines the AS or router that will be used as a fallback.

descr

A brief description of the object, typically the organization or business name.

e-mail

An email address for contacting a person or role associated with the object.

export

Defines the routing policy for sending routes to other networks. Specifies which routes will be shared with peers.

export-comps

Lists more specific routes that are allowed to be shared outside of an aggregation boundary.

fax-no

A fax number for contacting a person or role.

filter

Defines criteria for filtering routes based on attributes like IP addresses, AS paths, or communities.

fingerpr

A unique identifier that verifies the authenticity of a key certificate. Displayed as a hexadecimal code.

geoidx

While the GEOIDX attribute can be placed in the RADb (and other IRRs) route/6 objects, the use of this attribute type remains experimental and it is unlikely to resolve any geolocation errors. We follow the recommendations in the presentation linked here: NANOG IRR Additions. It is also helpful to include one line each for ISO 3166 Alpha-2, ISO 3166 Alpha-3, and ISO_3166-2:US Subdivision Codes, and UN M.49 geocodes. Many service providers do not query an IRR for this information. Instead, they use the country code information listed with the RIR WHOIS and commercial GeoIP databases.

The use of GEOIDX attribute is encouraged but ensuring ARIN's WHOIS service is up-to-date and correcting these databases is the best practice.

holes

Specifies IP address ranges within an aggregated route that are not reachable.

ifaddr

Defines an IP address and subnet mask for a router interface.
Format:

ifaddr: <ipv4-address> masklen <integer>

import

Defines routing policies for receiving routes from other networks. Specifies which routes will be accepted from peers.

inject

Specifies how and when aggregated routes are generated and applied. Can include conditions for when to update routing information.

inject: [at <router-expression>] ... [action <action>] [upon <condition>]

local-as

The AS number of the router’s owner or operator. Mandatory for inet-rtr objects.

member-of

Indicates which route sets, AS sets, or router sets the object belongs to. Defines group membership.

Note:

  • The max size of the member-of field is 4096 characters.

  • Add an additional member-of attributes if more ASNs are needed

members

Lists the individual members of a set object, such as routes, ASes, or routers.

Note:

  • The max size of the members field is 4096 characters.

  • Add an additional members attributes if more ASNs are needed

mnt-by

Specifies the maintainer responsible for the object. Used for authentication when making updates.

mnt-nfy

Email address to notify when updates to the object are successfully made.

method

Indicates the method used for digital signature verification, such as PGP.

nic-hdl

A unique identifier for a person or role object in the RADB. Used as a reference or contact handle.

Note:

  • You can only use admin-c and tech-c if the NIC handle you reference already exists in a person or role object in RADb.

  • If the NIC handle doesn’t match, the object won’t be accepted.

  • RADb also shows the linked contact information when someone views your record.

notify

An email address that receives notifications when the object is updated.

origin

Specifies the AS number that announces a specific route.
Example:

origin: AS12345

owner

The owner attribute is defined for the key-cert object. This is a generated attribute containing a description of the owner of the key. For a PGP key, the owners are the user id's associated with the key.

peer

The peer attribute, if present, specifies a protocol peering with another router. It is an optional attribute of the inet-rtr object. The syntax is as follows:

peer: <protocol> <ipv4-address> <options> | <protocol> <inet-rtr-name> <options> | <protocol> <rtr-set-name> <options> | <protocol> <peering-set-name> <options>

phone

The phone attribute is defined for person and role objects. It provides a contact phone number for the given entity.

remarks

General remarks. Can include an URL or RFC822 address (if preceeded by mailto:).

source

Identifier of the database containing authoritative data for this object. Use RADB for objects in the RADB Database.

tech-c

A technical contact. In the RADB, either a person's name or a NIC handle may be specified.

Note:

  • You can only use admin-c and tech-c if the NIC handle you reference already exists in a person or role object in RADb.

  • If the NIC handle doesn’t match, the object won’t be accepted.

  • RADb also shows the linked contact information when someone views your record.

trouble

The trouble attribute is defined for the role object. It is an e-mail contact address for problem/abuse reports.

upd-to

The upd-to attribute is specific to the mntner class object. It specifies the e-mail address to notify in the case of an unsuccessful update attempt to an object maintained by the given mntner object.

Please contact RADb Support for Assistance at support@radb.net or (734) 527-5776.