Supporting Notes for the IPv4 First Allocation Request Form Filiz Yilmaz Bican, Emma Bretherick, Agata Peszkowska, Ingrid Wijte Document ID: ripe-312 Date: 26 April 2004 Obsoletes: ripe-236, ripe-273 See also ripe-311 _________________________________________________________________ Contents Introduction Supporting Notes for the Request Form Templates Example References Introduction This document contains instructions for completing the 'IPv4 First Allocation Request Form'. It is a tool for gathering the information necessary to evaluate the request and to ensure that the same guidelines are applied to each request. Where necessary, the RIPE NCC will ask for additional information. The 'IPv4 First Allocation Request Form' can be found at: http://www.ripe.net/ripe/docs/first-allocation.html This form should be sent following the submission of 'Provider Aggregatable (PA) Assignment Request Form(s)' found at: http://www.ripe.net/ripe/docs/iprequestform.html Supporting Notes for the Request Form Templates #[GENERAL INFORMATION]# request-type: ipv4-first-alloc form-version: 1.1 Please do not alter the value of the 'request-type' and 'form-version' fields. x-ncc-regid: The Registry Identifier (RegID) must be included in every message sent to . It is used to identify the Local Internet Registry (LIR). It has the following format: . Warning: Requests sent to the RIPE NCC that lack a proper RegID (x-ncc-regid) will bounce back to the sender. #[REQUESTER TEMPLATE]# % % Please enter the details of the person at your Local % Internet Registry (LIR) who is submitting this request. name: phone: fax-no: e-mail: nic-hdl: A nic-handle (nic-hdl) is a unique identifier for a person or a role object. It is generated by the database when creating the object. It has the following format: [number]-RIPE For example: HOHO15-RIPE More information can be found at: http://www.ripe.net/ripe/docs/databaseref-manual.html #[CURRENT ADDRESS SPACE]# % % Does the organisation (LIR) that is submitting this % request have address space in use for infrastructure % Enter "Yes" or "No". current-address: If your organisation already has IP address space please state "Yes" (this does not include address space for customers' networks). #[CURRENT ADDRESS SPACE PREFIX TEMPLATE]# % % If you have answered "Yes" to the question above please % list prefixes currently used. % actual-prefix: Please repeat the 'actual-prefix:' field for all subnets currently in use by your organisation. In the 'actual-prefix' field please enter the actual prefixes in CIDR (slash) notation that you are currently using (i.e. x.x.x.x/xx). #[DATABASE TEMPLATE(S)]# % % Please fill in the necessary details below so that the % Hostmaster can create an inetnum object after allocating % a block to you. If it is necessary to create a maintainer object % please include that template too. inetnum: netname: descr: [Provider / Enterprise] Local Registry descr: *specify the name of the LIR's organisation* country: *specify the country code* org: *specify org ID here* admin-c: *insert nic-handle of administrative contact* tech-c: *insert nic-handle of technical contact* status: ALLOCATED PA mnt-by: RIPE-NCC-HM-MNT mnt-lower: *specify mntner name here* mnt-routes:*specify mntner name here* notify: *specify e-mail address* changed: hostmaster@ripe.net source: RIPE The "inetnum:" attribute (the IPv4 network range) should be left blank. It will be chosen by the RIPE NCC from the available IPv4 address space allocated to it by the Internet Assigned Numbers Authority (IANA). The "netname:" attribute should be left blank. It will be chosen by the RIPE NCC. The first "descr:" attribute will always indicate that this network is allocated to either a Provider or an Enterprise LIR. In the second "descr:" attribute enter the registered/legal organisation name of the LIR. The "country:" attribute describes the country or countries the network will operate in. If the network is multi-national a "#" can be used to allow multiple ISO country codes to be listed using a single "country:" attribute. For example: country: NL # ES IT The "org:" attribute should specify the Org ID for the organisation that will use the address space. This object must be created in advance. The "admin-c:" attribute contains the nic-hdl for the administrative contact person at the LIR. This person should be administratively responsible for the network. A role object nic- hdl can also be used in this attribute. The "tech-c:" attribute contains the nic-hdl for the technical contact person at the LIR. This person should have technical knowledge of the network and will preferably be working on- site. A role object nic-hdl can also be used in this attribute. The "status:" attribute must be ALLOCATED PA. The "mnt-by:" attribute must be RIPE-NCC-HM-MNT. The "mnt-lower:" and "mnt-routes:" attributes provide hierarchical authentication. They authenticate the creation of more specific inetnum objects or route objects within the allocation block. The LIR's maintainer must be referenced here. The "notify:" attribute specifies the e-mail address that will receive notifications of any changes made to the object. The "changed:" attribute must be hostmaster@ripe.net. The "source:" attribute must be RIPE. If you already have a maintainer there is no need to complete the mntner template below. mntner: *specify mntner name here* descr: *descriptive comments* admin-c: *insert nic-handle of administrative contact* tech-c: *insert nic-handle of technical contact* upd-to: *specify e-mail address* mnt-nfy: *specify e-mail address* auth: *specify authorisation* mnt-by: *specify mntner name here* referral-by: RIPE-DBM-MNT changed: hostmaster@ripe.net source: RIPE The "mntner:" attribute should reflect the LIR's organisation name. The "descr:" attribute should be used to give a short description of the object. For example: "Maintainer for objects of " The "upd-to:" attribute specifies the e-mail address that will be notified of all failed attempts to modify objects protected by the maintainer. The "mnt-nfy:" attribute specifies the e-mail address that will be notified of all successful updates to objects protected by the maintainer. The "auth:" attribute specifies the authentication scheme you have chosen to protect your objects. The different schemes can be found at: http://www.ripe.net/ripencc/pub-services/db/security.html PGP cannot be used as authentication when creating a maintainer. If you wish to use PGP you must choose another authentication and then modify the object after its creation. In the "mnt-by:" attribute you should enter the name of the maintainer protecting this object. Usually this will be the same value as the "mntner:" attribute, as the object will protect itself. The "referral-by:" attribute must be RIPE-DBM-MNT. The "changed:" attribute must be hostmaster@ripe.net. The "source:" attribute must be RIPE. #[INSERT SUPPLEMENTAL COMMENTS]# % % Please add any supplementary information that you think % may facilitate the evaluation of this request below. % % Please give an explanation of how much address space you % expect to assign within the next three months. This information % will facilitate the evaluation of your first allocation size. You may also use this area/space for any additional comments you feel are important and did not fit within the previous templates. #[END OF REQUEST]# Please insert your signature in plain text (with your full name) after the above header. The Robot will not process any information included here. Example #[GENERAL INFORMATION]# request-type: ipv4-first-alloc form-version: 1.1 x-ncc-regid: nn.santa #[REQUESTER TEMPLATE]# % % Please enter the details of the person at your Local Internet % Registry (LIR) who is submitting this request. name: Santa Claus phone: +999 555 5555 fax-no: +999 555 5556 e-mail: santa.claus@nowhere.nn nic-hdl: HOHO15-RIPE #[CURRENT ADDRESS SPACE]# % % Does the organisation (LIR) that is submitting this % request have address space in use for infrastructure % Enter "Yes" or "No". current-address: Yes #[CURRENT ADDRESS SPACE USAGE TEMPLATE]# % % If you have answered "Yes" to the question above please % list prefixes currently used. % actual-prefix: 193.1.193.0/26 actual-prefix: 193.1.193.64/27 actual-prefix: 193.1.193.96/27 actual-prefix: 193.1.193.128/25 actual-prefix: 193.1.193.0/24 #[DATABASE TEMPLATE(S)]# % % Please fill in the necessary details below so that the % Hostmaster can create an inetnum object after allocating % a block to you. If it is necessary to create a maintainer object % please include that template too. inetnum: netname: descr: Provider Local Registry descr: Santa's Workshop Inc. country: NN org: ORG-SANT1-RIPE admin-c: HOHO15-RIPE tech-c: HOHO15-RIPE status: ALLOCATED PA mnt-by: RIPE-NCC-HM-MNT mnt-lower: SANTA-MNT mnt-routes: SANTA-MNT notify: ripe-notify@nowhere.nn changed: hostmaster@ripe.net source: RIPE mntner: SANTA-MNT descr: Santa's Workshop Inc. Maintainer admin-c: HOHO15-RIPE tech-c: HOHO15-RIPE upd-to: santa@nowhere.nn mnt-nfy: role@nowhere.nn auth: MD5-PW $1$rHVeTQ7w$wywuM6zU2zZhA9HfDu4o4/ mnt-by: SANTA-MNT referral-by: RIPE-DBM-MNT changed: hostmaster@ripe.net source: RIPE # [INSERT SUPPLEMENTAL COMMENTS]# % % Please add any supplementary information that you think % may facilitate the evaluation of this request below. % % Please give an explanation of how much address space you % expect to assign within the next three months. This information % will facilitate the evaluation of your first allocation size. All current address space listed will be returned to nn.teleco (our previous provider) three months after we receive an allocation. We expect to assign a /23 and a /24 for our own infrastructure and a further /23 for customers within the first three months. #[END of REQUEST]# Best Regards, Santa Claus Network Administrator Santa's Workshop Inc. References IPv4 Address Allocation and Assignment Policies in the RIPE NCC Service Region http://www.ripe.net/ripe/docs/ipv4-policies.html RIPE Database User Manual: Getting Started http://www.ripe.net/ripe/docs/db-start.html Smallest RIPE NCC Allocation / Assignment Sizes http://www.ripe.net/ripe/docs/smallest-alloc-sizes.html RIPE NCC LIR Portal https://lirportal.ripe.net/